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Overview 



LiquidPixels LiquiFire allows users to dynamically create and manipulate images on- 
demand, in real time. Images are created or altered by sending commands to the Liq- 
uiFire server, which will perform the operations and return the processed image. 

LiquiFire presents many capabilities to the web designer, such as support for all pop- 
ular image file formats, ability to render and manipulate vector images such as 
Encapsulated PostScript (eps) and Scalable Vector Graphics (svg), full International 
Color Consortium (ice) color management, international (Unicode) typographic 
support, and manipulation of Exchangeable Image File (exif) and International Press 
Telecomminications Council (iPTC) metadata. Metadata - information about infor- 
mation - is data carried along with an image to convey additional details or charac- 
teristics beyond the picture itself. 

LiquiFire assets such as images, image chains, color profiles, and fonts, can be 
acquired from many sources - over HTTP, ftp, or from an image repository on a Liq- 
uiFire server. They can be processed by requests sent to a LiquiFire server. Requests 
are a series of LiquiFire commands, described in detail in "Base Command Set" on 
page 73. 

While LiquiFire is a very complex and powerful environment empowering the web 
designer with unmatched capabilities, it doesn't need to be intimidating - simple 
color, size, or format adjustments are extremely straightforward, and the most com- 
plex processing operations can just as easily be expressed. No detailed knowledge of 
imagery, file-formats, or image processing is necessary to take advantage of Liq- 
uiFire's potential. 

The LiquiFire environment is managed via LiquiFire Orb™ - a sophisticated web- 
based environment through which all aspects of LiquiFire operation may be con- 
trolled. All configuration, maintainence, and monitoring that is required to operate 
a single server or LiquiFire cluster environment can be performed from within Liq- 
uiFire Orb. 



Digital images are the obvious basis for all LiquiFire processes. Images exist in many 
forms on the Internet, but in LiquiFire they can all be thought of in a single, unified 
fashion. 

An image is comprised of one or more frames -2, series of sub-images contained 
within one main image - which when rendered represent an array of pixels that can 
be displayed or printed. 

In addition to being comprised of frames, images may: 

• be described as pixels or as instructions 

• contain image-specific metadata 

• contain esoteric metadata 

• have transparent regions, known as alpha channels 

Metadata is information carried along with an image that may be used for informa- 
tional purposes. The width of an image, its format, original source, etc., are all exam- 
ples of metadata. Images in LiquiFire always maintain their metadata throughout the 
image chain. Metadata is discussed more fully later, in "Image Specific Metadata" on 
page 13. 

The Image Pool 

When working with images in LiquiFire, images may need to be acquired or created. 
As images are introduced by a command in a request, these images reside in an image 
pool- a temporary collection of images maintained during each request. A separate 
image pool is created for each request, and is drained when the request is complete. 
Images in the pool are named so they can be identified and manipulated. 

A special image in the pool - the current image, has a special name: '..'.All imaging 
operations affect the current image. 

Certain commands add images to the image pool, and will accept an optional name 
argument by which the image in the pool will be known. If two images are named 
identically, the latter replaces the former in the pool. 

Images in the LiquiFire environment may have multiple frames. If the file from 
which an image is retrieved supports multiple frames, it will be added to the pool 
just as any other image via the source command. As well, frames may be also 
added to images already in the pool. Once a multiple-frame image is in the pool, 
individual frames may be selected with the select command and subsequently 
manipulated as an independent image. 
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Image Chains 



The image chain, the heart of a LiquiFire command, is a representation of a sequence 
of steps necessary to create the desired result image. 

Image Chains are built within LiquiFire by sending a series of commands, called a 
request. As the request is processed, each command is interpreted, in sequence, 
resulting in the creation of an image chain. The image chain, along with its associ- 
ated metadata is contained within zjob. 

There are three types of commands which may be sent to LiquiFire: direct, macro, 
and metacommands. Direct commands are the most common, resulting in the addi- 
tion of an Operator to the image chain. Macro commands, may perform additional 
computation or processing, such as database queries, calculations, etc., before 
optionally adding zero or more Operators to the image chain. Finally, metacom- 
mands allow manipulation of non-image data (metadata) associated with the 
request. 

Request 




FIGURE !. Command Processing 



Let's look at a simple example: 



Suppose you want to display an image in a web page within a space 200 pixels wide 
and 200 pixels tall. There are three steps required to process this image: Acquire the 
source image, scale it to the desired size, and send it to the requesting browser in a 
format the browser understands. 



Graphically, the request might look like: 



3 




Scale to 
within 
200 x 200 
pixels 




FIGURE 2. Simple Request Representation 

The above illustration shows three direct commands within a simple request. These 
three direct commands will each create a single operator in the image chain. 



Source 



Scale 



-SHI 



Sink 



200,200 



FIGURE 3. An image chain 



The resulting image chain is no more complex. 



Chain Representation 

Image chains themselves are not directly created. Rather, they are represented as a 
sequence of commands, each with a list of optional arguments. Each command rep- 
resents one or more operators, macros or metacommands. These commands, in 
turn, are interpreted to create the image chain. 

Image chains can be represented in many different ways. In fact, while LiquiFire 
understands image chains represented as either HTTP or XML, additional representa- 
tions can be added to LiquiFire if needed. 

The example depicted in Figure 3 contains three operators, with the second having 
two arguments, width and height. This example can be represented with three corre- 
sponding commands in an HTTP request. 

The HTTP syntax for LiquiFire is designed to be simple to read and develop. For the 
technically inclined, the Modified Backus-Nauer form (mBNF) of the HTTP request 
is listed in the Appendix, "HTTP Syntax Definition" on page 1 87. 



Commands are identified by name, and may result in one or more (as in the case of 
a macro) operators being added to the image chain. Optional named arguments 
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begin with an equals sign V and are separated by commas ' , ' with their values sur- 
rounded by square brackets (* V and ' ] Commands may have zero or more argu- 
ments. 

conmand3SIame=argumentTSIame [value] , another Arg [AnotherValue] . . . 



FIGURE 4. Example Command Syntax 

This Users Guide will focus solely on the http representation of LiquiFire requests. 
In the http request form, commands are processed in sequentially, and are separated 
in the request by an ampersand character as per the http standard for get requests: 

commandOne=argOne [valueOne] , argTwo [valueTwo] &corraaandTwo& . . . 



FIGURE 5. Multiple Commands 

For legibility in this document, Returning to our simple image-scaling example above, represented as a real LiquiFire 
Requests within the examples Request, it might be: 
may be separated into several 

lines. scurce=url [http: / /www. liquidpixels .net /images /cat . jpg] & 

3 cal o=geomet ry [ 2 0 0x2 0 0 ] & 

sink 



FIGURE 6. Simple LiquiFire Command 

Here we can easily see the three commands, source, scale, and sink, together in 
a single request. 

Multiple Images 

Many requests will need to perform processing on more than one image. Yet the 
image chain representation becomes no more complex. In this example, one image is 
composed with another - the secondary image is blended, or layered, with the first 
at the location specified in the chain. 



Graphically, the chain we would like to create looks like: 
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FIGURE 7. Multiple Image Chain 



n 



Since requests are represented as a sequence of commands, we must use references to 
other commands to describe a bifurcated chain. The image chain above could be cre- 
ated by the following LiquiFire request: 



source=url [http: //www. liquidpixels .net /images /penguin. gif ] , 
nameEp] & 

source=url [http: //www. liquidpixels .net /images /truff . jpg] & 

composite=compose[Over] , image [p] ,x[200] / y[100 3& 

sink 



FIGURE 8. Multiple Image Commands 




figure 9. Simple Composition 



Notice in this example there are two source commands, with the first one addi- 
tionally specifying a name argument with the value of V . This additional argument 
tells LiquiFire to take the penguin . gif image and add it to the pool as an image 
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named *p\ The second source command does not specify a name - the image is 
added to the pool as the current image, or'.'. 

The composite transform operator requires a composition type specified by the 
compose argument and the name of an image in the pool to compose with the cur- 
rent image, specified by the image argument. The optional x and y arguments define 
an offset for the composition. Complete details of all the commands and their argu- 
ments is in the chapter, "Base Command Set" on page 73. 

Now lets look at a small change to the previous example: 

source=url [http : //www. liquidpixels . net / images /truff . jpg] , 
name [cat] & 

source=url [http: / /www. liguidpixels.net/irnages/penguin.gif ] , 

name[p] & 
select=name [cat ] & 

compos it e=compose [Over] , image [p] ,x[200] ,y[200]& 
sink 



FIGURE 10. Alternative Composition Commands 

There are two differences here. First, the order of the source commands has been 
reversed, and both source commands specify image names. Second, there is a new 
command: select, used to make one of the images in the pool the current image. 
Functionally, this example is no different from the previous, but it can be easier to 
understand, since the current image' is no longer an inferred assignment. 

Asset Sources 

As noted earlier, LiquiFire assets can be acquired from many sources. The source of 
an asset is specified as a URI, with the http://, shttp://, ftp://, gopher:, and file: 
method types supported. Additional types may be added to LiquiFire. 

For the common network based methods, the asset is retrieved from the location 
specified by the URI to the LiquiFire server where they are stored and managed by 
LiquiFires intelligent caching system. If the original image is altered, it will be re- 
transferred to LiquiFire, otherwise, once the image is managed by LiquiFire, it is not 
re-transferred unnecessarily 

URIs utilizing the file : method direct LiquiFire to retrieve the specified asset from 
the local LiquiFire Asset Pool. Assets may be added to and managed within the Asset 
Pool via LiquiFire Orb, discussed in "Resident Assets" on page 46. 
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Vector formats allow for limitless 
scaling and rotation of imagery 
without the pixel re-sampling 
and resulting reduction of quality 
otherwise necessary. 

Certain situations will warrant the introduction of a new (possibly blank or pat- 
terned) image into the image chain. Perhaps a transparent spacer image is needed, or 
a background on to which text will be drawn. The blank command adds a blank 
image creation operator to the image chain. 

The blank command is used to add an operator to the image chain that creates a 
new solid image in the image pool: 

blank=color[red] , width[100 j , height [30] & 
sink 



Images can be acquired in an ever-growing list of file formats, including formats that 
do not represent images as pixels, such as PostScript™, Encapsulated PostScript 
(EPS) or Simple Vector Graphics (SVG). 

Image Creation 



FIGURE 1 1. Creating a new image 

The new image can be created in any color desired, with many standard colors avail- 
able by name. The complete list of named colors and the format for specifying cus- 
tom colors is in the Appendix, "Color Definitions" on page 173. 

Stored Chains 



Note the difference between a 
macro command and a stored 
chain. Macro commands are exe- 
cutable computer code designed 
to perform complex, and often 
custom, operations during image 
chain creation. Stored chains, on 
the other hand, allow users to 
store often used request frag- 
ments for simple re-use later. 



LiquiFire image chains can be stored to disk and can be retrieved from disk or any 
network accessible location. This ability to store image chains - as portions or com- 
plete chains - allows users to amass a library of imaging functions which can be 
assembled later to perform imaging tasks. Coupled with the use of esoteric metadata 
(see "Metadata" on page 13) and the set command (page 168), stored chains can 
behave as junctions, allowing simple URLs to achieve powerful results. 

Suppose you wish to adorn a set of web pages with section tabs similar to the one 
below: 



FIGURE 12. A Graphic Tab 

With the graphic for the image tag created as an EPS file, the following image chain 
could be used to create a section tab with a section name: 
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source=url [ file: tab. eps] & 

annotate=font [Arial-Roman] , point size [9 ] , text [ Sect ion+One] , 

gravity [Center] , fill [black] & 
sink= format [GIF] 



figure 13, Section Tab 



Since stored chains are refer- 
enced by URI just as any LiquiFire 
asset, they may be stored within 
the Resident Asset Pool or any 
network-accessible web of FTP 
server 



With this simple image chain, section tab images can be easily created for any area of 
the web site, without needing to create them ahead of time. 

With stored chains, however, this repetitive process can be made simpler. By replac- 
ing the text argument in the annotate command with a reference to global esoteric 
metadata, a portion of this image chain becomes a reusable function stored on the 
LiquiFire server. Notice that the sink command was omitted from the request. 

source=url [ f ile : tab . eps ] & 

annotate=f ont [Arial -Roman] , pointsize [9] , 

text [gl ofoal , socti on] , gravity [Center] , fill [black] 



FIGURE 14, Section Tab Fragment 



Image chain fragments can be stored on any server in a file, and can be retrieved as 
part of a request by using the load command (see "load" on page 165). The set 
command (see "set" on page 168) can be used to assign values to global metadata 
fields within stored fragments. If the image chain fragment above in Figure 14 was 
stored on a web server http : / /www . domain . com in the file /chains / 
tab . chain, then the following image commands could be used to create a tab 
graphic: 

set=key [section] , value [Section+One] & 

load=url [http: //www. domain. com/chains /tab. chain] & 

sink 



FIGURE 15. Using a Stored Chain 



Resulting in a customized tab image: 



FIGURE 16. Custom Tab Image 
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Resident Assets LiquiFire assets - images, fonts, stored chains - can be retrieved from any valid URL. 

LiquiFire supports the file: method within these URLs, indicating that the asset 
should be retrieved from the LiquiFire resident asset pool. This section describes 
LiquiFire Orbs facilities to manipulate and explore the asset pool. 

LiquiFire s asset pool is divided into three distinct sections, each matching a corre- 
sponding type of data and therefore, matching a class of commands. The source 
command looks to the art asset pool; annotate, text, mf text, and textcurve 
look to the fonts asset pool; and the load command looks to the chains asset pool. 
Additionally, the addprof ile command looks to the art asset pool for ICC color 
profiles. 

When several LiquiFire servers are installed as a cluster, each slave server accesses a 
synchronized copy of the master s Resident asset pools, providing unified access to 
assets without any reduction in performance. Synchronization occurs on a regular 
basis, determined during configuration via LiquiFire Orb, and can be performed 
manually at any time. 

Additional information regarding the Resident asset pools, manipulation capabilities 
of LiquiFire Orb, and cluster synchronization can be found in "Resident Assets" on 
page 46. 
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SSiOPS LiquiFire commands may contain arbitrary mathematical expressions which will be 

evaluated when the image chain is created from the request. Expressions are enclosed 
by parenthesis * ( ' and 4 } and may contain references to image metadata fields. 

Expressions are an important element of LiquiFire s flexibility. They permit image 
manipulations to be constructed in situations where certain aspects of the source 
image or the necessary target are not known, or when metacommands are used to 
make decisions during rendering. 

Simple expressions are useful to increase clarity within some operation. For example, 
let's look again at the penguin composition example on page 6. In this case, however, 
lets position the penguin at the center of the underlying cat image. To do this, we 
need to know the size of the cat image - information which we don t have available, 
but can use expressions (and image metadata) to determine. 

source=url [http://www.liquidpixels.net/images/penguin.gif] , 
name[p] & 

source=url [http: //www. liquidpixels .net/ images/truf f . jpg] & 
composite=compose [Over] , image [p] , 

x[ { .width/?) ] ,y[ ( .height/2) ]& 
sink 



FIGURE 17. A Simple Expression 



Notice that the image specified 
in the second source com- 
mand above, while not explicitly 
named, can still be identified by 
the current image name 



The identified image metadata width and height (see section "Metadata" on 
page 13) are each used within small expressions to determine the center of the cur- 
rent image (named '_'). 

Expressions in LiquiFire are not typed - an expression resulting in a numeric result 
can be used later as text to be drawn onto an image. Likewise, textual, yet numeric 
metadata can be used within arithmetic expressions. 

Certain characters may not be permitted within a request of a specific form. HTTP 
requests, for example, present a limited character set due to the use of several charac- 
ters by the protocol to indicate special meaning. In all cases, however, encoding tech- 
niques specific to the representation can be used to overcome this limitation. 
LiquiFire Explorer, a component of the Orb management environment, can assist 
with URL encoding. 

Several Metacommands are available that perform decision making operations such 
as if-then, string matching, or time and date determination. These Metacommands 
all perform by manipulating global metadata, and the results of their operation can 
be used within expressions. Let s look at a more complex example: 
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blank=width[600] , height [60] ,name[bg]& 
annotate=text [Only] , font [Arial-Bold] ,pointsize [22] , 

fill [black] ,y[35] ,x[10]& 
annotate=text [days+lef t+till+Christmas] , font [Arial- 
Bold] ,pointsize[22] , 

fill [black], y [35] ,x[150]& 
count down= target [12/25/2001] , key [days 3 & 

annotate^text [global .days] , font [Dominican] , pointsize [36] , 

fill[red],y[40],x[82]& 
optimizes: 
sink= format [gif ] 

FIGURE 18. Countdown Example 

In the previous example, the number of days remaining until Christmas 2001 is 
determined by the countdown metacommand supplied with LiquiFire. The result- 
ing number is placed in the global metadata in a field named days, specified by the 
key argument in the countdown command. Each time this request is processed, the 
operators that result may contain different values, based on the number of days 
remaining. This information is used by the annotate command later in the request 
to draw a custom message on the image. Simple, yet very powerful. 

Conditional Execution 

,2 Sometimes there are situations where a command within a request should only be 

executed if a certain criteria is met. Perhaps an image should only be reduced if it 
£j exceeds a certain size. Or, perhaps, only images in CMYK should only be converted to 

"7 RGB, as illustrated in Figure 19. LiquiFire's conditional execution of commands 

allows for command processing to occur only if a criteria is valid. 

source=url [http: //www. liquidpixels .net /images /Spain. jpg] , 

name [image] & 
scale=size[500] & 

addprofile=url [ file: pro f iles/sRGB. icm] , 

i f [ { M rxage . ccl cspacc ' nc ' PGR ' } ] & 
sink 

FIGURE 19. Conditional Execution Example 

Any LiquiFire command may contain an additional special argument, 'if', when 
the if argument is present for a command, the value of the if argument is evaluated, 
and the command will be skipped during processing if the value is numerically zero 
or blank. 
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Metadata Images have two components: a visible component, represented as pixels, vector 

information, or instructions, and a non-visible component called metadata. Meta- 
data comes in two forms, image-specific metadata, representing physical aspects of 
an image (height, width, color depth, format, etc.) and logical aspects of an image 
(cached, name, etc.) and esoteric metadata, representing any additional information 
associated with an image by the user. Image-specific metadata is inherent to the 
image, it can not be changed explicitly, while esoteric metadata can be arbitrarily 
manipulated as needed. Esoteric metadata can be manipulated by the attribute com- 
mand. 

Both types of metadata are available to LiquiFire commands within a request. There 
is no distinction made between image and esoteric metadata within a request. 

Metadata is accessed by image pool name, followed by a dot ' . ' And the name of the 
metadata field desired. For example, the string cat. width could be used within a 
command to determine the width of an image named cat. The current image can 
also be queried for metadata, even when it is not explicidy named by using an 
underscore as the image name L- width). 

Beyond metadata associated with an image, there is also metadata associated with a 
request. This metadata, solely esoteric, can be used to pass information between 
commands in a request, much as variables are used in programming languages. 
Request-centric metadata is known as Global metadata, and is accessed via a special 
image name global. 

Esoteric metadata can be set globally or specifically for an image by using the set 
metacommand, or by certain other metacommands and macros that may make deci- 
sions or calculations earlier in a request. 

Image Specific Metadata 

Two forms of image-specific metadata are detected and extracted by LiquiFire for use 
in image chains: iptc metadata and EXIF metadata. 

The International Press Telecommunications Council, or IPTC, defines a format for 
the exchange of metadata in news content including photographs. Many desktop 
imaging applications allow you to add IPTC metadata to your images, or view any 
data already in place. The IPTC metadata fields are listed in "IPTC Metadata 5 on 
page 193. 

The EXIF, or Exchangeable Image File, defines a common format for image inter- 
change in use by most digital cameras on the market today. Along with the image 
capture, devices supporting EXIF will populate the EXIF metadata fields with camera- 
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and possibly location-specific information known at the time of capture. The EXIF 
metadata fields are listed in "EXIF Metadata" on page 196. 

Both exif and iptc metadata can appear in an image together. 
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NOH- Imaging Non-Imaging commands are commands which, when executed, result in the addi- 

COmm3.ndS t * on °^ zero 0r more new °P erators added to the image chain. They differ from basic 

commands in that they do not perform imaging operations themselves. Rather, they 
are useful to make decisions, fetch data from an external source, perform repetitive 
commands, and to reduce complex, yet often-repeated imaging operations into a 
simple single command. 

Non-imaging commands can be separated into two categories: metacommands and 
macros. 



Metacommands 

Metacommands are commands intended to manipulate metadata. LiquiFire has sev- 
eral stock metacommands: 



Command 

countdown 

fontmetrics 

regexcase 
set 

timecase 



Function 



Reference 

page 161 



Calculates the time remaining from the current time until 
the date specified. 

Determines the future resulting size of text when rendered in page 1 64 
a specified font and size. 

A case statement for string expression matching. page 166 

Sets a field in the global metadata to the value specified page 168 

Given a list of dates, times, or date-times, returns the page 170 

corresponding value when the current time falls within one 
of the specified ranges. 



Macros 



LiquiFire is designed to be extensible. One of the areas in which LiquiFire can be 
extended is via the development of custom Macros. A macro appears as any other 
command within a request, but may be designed to perform complex computations, 
database access, or other computations as precursor steps to adding zero or more 
operations to the image chain, or setting esoteric metadata. A macro may, for exam- 
ple, be developed to query a database of product information and set esoteric meta- 
data to the current price. This metadata could then be used later in the request to 
image sale information on the image, or as the basis for conditional execution of a 
command. 



Certain macros are simple conveniences - the common use of LiquiFire to create an 
image containing styled text rendered in an attractive typeface can be simplified via a 
macro. To do this takes without a macro three steps: first, determine the size of the 
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text to be rendered, in pixels, second, create a new blank image of that (or slightly 
larger) size; and third, render the text onto the new blank image. The text macro 
does just this: it calculates the bounding box for the text to be rendered, and then 
adds two new operators to the image chain: a blank operator and an annotate opera- 
tor. 

LiquiFire macros can be developed by LiquidPixels to customize the LiquiFire envi- 
ronment for your needs. 
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SGCUrity In most environments, there is no need to restrict access to a LiquiFire server or clus- 

ter. Some environments, however, will require certain restrictions to be placed on 
access to the server. 



LiquiFire security is disabled by default. See "LiquiFire: Host" on page 28 for infor- 
mation on using LiquiFire Orb to enable security and how to select the types of 
restrictions. See "LiquiFire: Client Access" on page 31 for further information 
regarding the creation of host access lists. 

There are two mechanisms by which access to a LiquiFire server can be restricted: 
referring host, and keyed requests. 



Referring Host 

This method is most applicable to websites using LiquiFire for imaging within their 
own environments or a limited number of external environments. It is not a desir- 
able mechanism for securing LiquiFire access within the arena of HTML e-mail. 

When a web browser makes a request to a server, it sends with the request informa- 
tion describing the HTML resource that referred the request. When following a link 
from one HTML page to another, for example, the browser informs the web server of 
the URL from which the second page is accessed. When a browser makes a request 
for an image, the web browser will inform the server the URL of the page containing 
the image tag. 

It is this information that LiquiFire uses to restrict use of a LiquiFire server by alien 
sites. To do this, LiquiFire must be presented with a list of server names (or URLs) 
for which requests are permitted. Once the list is complete, and host based security 
is enabled, any attempts to access LiquiFire via an image tag served by a server not 
listed will not be permitted. Operation is transparent when the request is made from 
a web browser, even under JavaScript control. 



Keyed Requests 

When requests are made from a non-browser environment - HTML e-mail, a Java 
applet, an application - the referrer information used in host based security is not 
present. In this case, an additional command must be added to the LiquiFire chain 
containing a key, unlocking LiquiFire for that request. 

A unique key is created for each request to be made; keys are based on the image 
chain itself, and a secret' known to the LiquiFire owner. Keys may be created by 
using LiquiFire Configurator, or by implementing the algorithm available from Liq- 
uidPixels. 
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Lets look at a quick example of a keyed request. Suppose you wish to use LiquiFire 
to perform the following imaging manipulation: 

source=url [http: //www. liquidpixels .net /images /cat . jpg] & 

scale=geometry[2 00x200]& 

sink 



FIGURE 20. Simple Request 

Attempting to make this request to a LiquiFire server configured to have key based 
security enabled will result in an access denied error. To unlock LiquiFire, we first 
must generate the key for this request via configurator. The resulting key might look 
like c!409fb30 or UmFuZG9tSVb;% 7 OPNcmpQylSiDuszzKIciO+s>A'svhmpYY^ 5 
depending on the strength of the key you requested, a hash or cipher, respectively. 

Once the key has been obtained, the request is slighdy modified to include this addi- 
tional information: 

source=url [http: //www. liquidpixels .net /images/cat . jpg] & 
scale=geometry [200x200] & 

euzh=ha ch " d4 n 9 fb3 C " & 
sink 



FIGURE 21. Simple,Authorized Request 

The auth command may appear anywhere in the image chain. See "auth" on 
page 161. 
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Cache LiquiFire maintains two separate cache systems: an asset cache, for source images, 

fonts, profiles, and stored chains; and a render cache, for rendered images. Both 
caches perform the same basic function, to keep recently accessed data near-by such 
that subsequent accesses are as rapid as possible. 



'ft. jj 



Asset Cache 

When any asset is requested via URL in a command such as source or annotate, the 
asset is retrieved from the location specified and stored within the LiquiFire Asset 
Cache. Subsequent requests for the same asset will use this cached copy, saving the 
overhead of the network retrieval. 

In clustered LiquiFire environments, this asset cache is automatically synchronized 
to appear as a single, unified, transparent cache. LiquiFire Orb can be used to 
remove individual items, flush the entire Asset Cache, or initiate validation of the 
cached data with the original remote assets. See page 51 for further information. 

Render Cache 

Similar to the Asset Cache, LiquiFire maintains a cache of all rendered images. This 
cache is used to accelerate repeat requests for a chain, serving the cached result rather 
than re-render the image. The decision to return a cached image is based on the 
request; requests must match exactly to cause a cached response to be used. 

LiquiFire s Render Cache subsystem yields very high performance, and may be used 
as a mechanism to serve pseudo-static images - images which are dynamic, but 
which change infrequently - in a fashion akin to conventional batch processing. 

LiquiFire Orb can be used to remove individual items, or flush the entire Render 
Cache. See page 49 for further information. 
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chapter 2 LiquiFire Configuration 



LiquiFire is a complex environment. That said, there are only a few simple configu- 
ration aspects that need to be performed to bring a new server on line. In fact, aside 
from entering basic host information in the "LiquiFire: Host" pane on page 28, 
there is no additional required configuration necessary. 

This chapter covers LiquiFire Orb, a Web-based tool used for LiquiFire configura- 
tion, mainainence, monitoring and access to other helpful tools. 
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Clustering LiquiFire can be installed as a single server, as multiple discrete servers, or as a 

cluster- a collection of servers working in concert as a single server. 

Multiple LiquiFire servers, or nodes, can be assembled in many varying configura- 
tions, depending on the task or environment. While typical configurations of single 
servers as well as a cluster containing a single Master and one or more slaves, it is 
possible to configure complex cluster architectures. 

Each LiquiFire server contains sevaral functional components. Nodes can be config- 
ured as a Master or Slave. Master nodes can perform image manipulations, but can 
additionally manage the other nodes in the cluster. Slave nodes perform as highly- 
efficient workers, operating to only perform rendering. 
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Orb 



LiquiFire Orb™ is a sophisticated web-based environment through which all 
aspects of LiquiFire operation may be controlled. All configuration, maintainence, 
and monitoring that is required to operate a single server or LiquiFire cluster envi- 
ronment can be performed from within LiquiFire Orb. 



Starting Orb 

LiquiFire Orb is accessed through any standard web browser at 

http : / / i psddxess : 8 8 / 



The name of the LiquiFire server 
you are accessing will appear 
below the Orb title, similar to 
the name LiquidPixels Public' is 
displayed in this example. If you 
have not yet configured the 
name of the server nothing will 
be displayed. 



where ipsddress is the ip address of your LiquiFire server. You will be presented 
with the LiquiFire login screen similar to Figure 22. 



LiquiFire™ Orb™ 

UqtiidFMs PabSc 





User-same; f 




Password: j 









Lfc,«)Fi™>™ Orb™ Vsretoi, I 12 

Gswrfcfit E200CL 2001 Lb udPbtck'^ loco ran rated 

M Aflfct Resetted 



FIGURE 21, Orb Login 

As shipped, Orb has a single account, with username liqui fire, and password 
admin.Using Orb, both the username and password can be changed later. It is 
strongly recommended that the default username and password be changed at the 
earliest opportunity, to prevent unauthorized access to LiquiFire Orb. LiquiFire Orb 
will automatically require you to re-login after a certain amount of inactivity. 

Once successfully logged in, you will be presented with the following screen: 
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FIGURE 23. Orb Main Screen 



o 


The top right area of the Orb screen presents up to four sections, representing the 
four actions of Orb may be used to perform. 


% a 

1M 


Section 


Functions Within 




Config 


Functions relating to the core configuration of a LiquiFire server, 
cluster member, or whole cluster. 


is 


Monitor 


Monitoring LiquiFire performance, activity, and behavior 


|«h 

H| 

;: 


Maintain 


Allows manipulation of LiquiFire asset storage for artwork, fonts, and 
chains, as well as to query or clear the asset and render caches 


1- 


Tools 


Tools for chain development, foreign-characterset exploration, and 
chain cipher generation 


5 


Logout 


Leaves LiquiFire Orb 



The options available may be restricted, based on the access permissions for the par- 
ticular Orb user. See "Administration: Users ' on page 26 for further information 
about Orb accounts and access permissions. 
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Configure 



The configuration section is used to control overall LiquiFire operation. This 
includes Orb account administration, LiquiFire server configuration, Cluster mem- 
ber management, and Remote Access. 



u 

W 



M 




FIGURE 24. Configure Section 



The Configure section controls five areas: 

• Administration: Orb accounts and access permissions 

• LiquiFire: detailed server, cluster, and database configuration 

• Remote Access: control aspects of LiquiFire remote accessability 

• License Key: view or update the current LiquiFire license key 

• Server Control: Start, Restart, and Stop LiquiFire 

If the LiquiFire server being configured is a slave, the Cluster option will not be dis- 
played. 
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Administration: Users 



ministration: Configurator LKets 



2p3f-0?-O42!HMO 

2GGI-OJ-06 

293 1-04-20 02-4&27 

2001-0*26 I&i5*42 
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FIGURE 25. Administration: Users 



As described above, LiquiFire Orb can be used for four purposes: Configuration, 
Monitoring, Maintainence, and Tools. The Users pane is used to Add, Edit, and 
Remove Orb users, each of which may be permitted to use all or some of the four 
sections. 

The pane illustrated in Figure 25 lists the current set of Orb users. Adjacent to each 
listed account are action buttons, as well as the New Account and Help buttons at 
the top of the pane. This layout is used throughout Orb. 

Command Description 

New Account 
Add a new Orb account 

Edit Account 
Edits a Orb account 

Remove Account 
Removes a Orb account 

Help 



w 
ft 



Clicking the New Account or Edit Account icon will display the edit pane, as illus- 
trated in Figure 26. Here the username and password for a user may be entered or 
changed, as well as select which of the Orb sections will be accessable by the user. 
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Administration; Configurator Users 



U surname; 



Monitor 
flamtam 
T«.~i> 



FIGURE 26. Administration: Users: Edit 



The default user account, liquifire, has access to all four sections enabled. Be sure to 
maintain at least one account with configuration access, or you will be unable to 
make further changes. 
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LiquiFire: Host 




FIGURE 27. LiquiFire: Host 

The Host pane is used to configure basic system and network settings for a LiquiFire 
node. It is devided into three sections: Network, allowing for basic host configura- 
tion, Cluster, describing aspects of the entire LiquiFire cluster, and Security, selecting 
which of the security modes should be active. 



Field 



Description 



Server Name 



Hostname 
Domain 

IP Address 
Port 



This field determines the human-readable name for the server. 
This name will be used to identify the server to the 
administrator within Orb, in diagnostic messages, and 
automated e-mail 

The network hostname of the node 

The network domain of the node. For example, 

3 iquxdplxels , net 

The IP address of the node 

The TCP/IP port on which the Rendering Engine should listen 
Typically 8 1 , this should only be changed when complex server 
environments require. 
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Field 



Description 



:i "is- 



Mailhost The IP address for the SMTP mailhost LiquiFire should use to 

send email, when required. 



Node Type 



FQDN 



Port 

Administrator s Email 
URI 

Security Type 



The node type, either Master or Slave. 

Nodes may be either Masters or Slaves. See page 22 for a 
detailed discussion of LiquiFire clustering. Single LiquiFire 
servers should choose Master; there must be at least one Master 
node in a cluster 

The Fully-Qualified Domain Name for this node. This is the 
name by which users will access the LiquiFire cluster, as a single 
logical entity. For a single node, this is typically the 
combination of the Node Hostname and Node Domain, 
above. For clusters or orher complex situations, such as where 
IP-Redirectors are used, this field may be different. 

The TCP/IP port on which the entire LiquiFire cluster should 
listen, typically 8 0 

The email address to which LiquiFire will send email in 
situations where problems or other notification is required 

The URI to which LiquiFire commands will be made. This is a 
single word, following the domain name in an HTTP request, 
illustrated in green: 

ht zp : / / li qui * i re . 1 i qui dpi xel s . net / i T.agc? 

Determines the security model to use when validating requests. 

See "Security" on page 17 for detailed information on LiquiFire 
security models. 



Autostait LiquiFire If enabled, LiquiFire and all its subsystems will be 

automatically started when the server is booted or rebooted. 
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LiquiFire: Cluster 
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FIGURE 28. LiquiFire: Cluster 



LiquiFire servers may be organized into a logical cooperative group called a Cluster. 
In a cluster, several nodes work in concert to share the overall burdon of creating, 
manipulating, and serving images. Clusters are managed by the Master node, and 
may have one or more slave nodes. On a Master node, this pane allows you to add , 
edit, or remove members from a cluster as slaves. The members you add may be 
either Masters or Slaves, according to your desired system design. See "Clustering" 
on page 22 for additional information on LiquiFire Clustering. 

Note that each node added to a Master node must, in turn, have the Master node 
listed as an authorized Master. See "Remote Access: Cluster" on page 35 for addi- 
tional information. 



While you can add cluster members by either fully-qualified domain name, or by IP 
address, we recommend that you use IP addresses exclusively. 

Members of the cluster may have differing port or URIs than the server to which they 
will be slaves. In these cases, enter the optional port or URI may be entered along 
with the IP address in the form ip:port/URI. For example, adding a member as 

192 . 168.0 .1 z8i /image specifies the slave at 192 . 3 68 , 0 . 3 be accessed via port 8 1 
with the URI i nage. 



Command Description 



Add Member 

Add a new member to the cluster. 
Edit Member 

Change an existing cluster member 

Remove Member 
Remove a cluster member 

Help 
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LiquiFire: Client Access 




FIGURE 29. LiquiFire: Client Access 

As described in "Referring Host" on page 17, one of the mechanisms available for 
authentication is to control access to a LiquiFire host by Referring Host. This 
approach requires a list of authorized referring hosts to be maintained. 

This pane allows you to manage the list of authorized hosts, by expression 1 . Each 
expression in the list is checked against the referring host, and if a match against any 
is found, the request is allowed. An expression of liquidpixel s \ .net, for example, 

would match www. 1 1 guidpixels . net as well as app: ezroe . 1 iqu: dpixel s . net. 

Command Description 

Add an Expression ~ ~~ ~~ " — ... 

Add a new access expression to the list. 
Edit Member 

Change an existing access expression 

Remove Member 
Remove an expression 

Help 



1. Regular Expressions provide a general mechanism for describing patterns of characters to match 
There are many good references on the Web containing detailed information. 
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LiquiFire: Cache 



LiquiFire: Cache 



Describe the cache characteristic! for this mfot 



® 



Subsystem: 
Memory? 



^Enabled G Disabled 



set Cache 

Expire every- Hours 
' Synchronic 4 » T H»vu'» 



FIGURE 30. LiquiFire: Cache 



it 



This pane controls the aspects of the Render Cache described in "Cache" on page 19. 
Each image rendered by LiquiFire is maintained in a complex caching system, allow- 
ing repeat requests to be optimised. 



Field 



Description 



Subsystem Enables or Disables the render cache. The Render Cache must be 

enabled for Cluster configurations. 

Size Determines how much disk space should be allocated to caching result 

rendered images, typically 100MB. 

Memory Determines how much memory should be allocated to caching result 

rendered images, typically 8 MB. In situations where large numbers of 
requests will likely be made to recently rendered images, it may be 
desireable to increase this value. 

Expire Every The number of hours after which LiquiFire will contact the original 
host to verify the asset still exists and has not changed. 

Synchronize The number of hours after which LiquiFire will synchronize the Asset 
Every cache contents between members in the cluster. 
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LiquiFire: Database 




Name: ' ' jn^nfireSp"™*^ 

Host: fmJi&K'\i~~ 
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FIGURE 31. LiquiFire: Database 

LiquiFire uses an internal database to manage many of its functions. In certain, spe- 
cialized situations, it may be desirable to override the default database with which 
LiquiFire communicates for cache and transaction information. This pane allows 
you to specify settings for those communications. 

Do not alter this information unless you know what you're doing. 



Field Description 

Name The database name in which transaction information is stored 

Host The hostname or IP-address of the server hosting the database 

User The database username 

Password The database password 

Name The database name in which cache information is stored 

Host The hostname or IP-address of the server hosting the database 

User The database username 

Password The database password 
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Remote Access: FTP Server 
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FIGURE 32. Remote Access: FTP Server 

LiquiFires local asset pool> conventionally managed by Orb as described in "Main- 
tain" on page 45, may alternatively be access via FTP using any common ftp client. 

Field Description 

FTP Server If enabled, The LiquiFire asset pool may be accessed via FTP 
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Remote Access: Cluster 



1 FU-nwu Access: Cluster 1 
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FIGURE 33. Remote Access: Cluster 

This pane controls which nodes are authorized to communicate with this node. If a 
Master node lists this node as a member of a cluster, the slave node, in turn, must 
authorize connections by the master by listing its hostname or IP-address here. 

Command Description 

Add a member 

Authorize a node to connect to the node as a Master 
Edit Member 

Change an existing member 

Remove Member 
Remove a member 

Help 
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License Key: View 



Lk^nseK*y: Vie 



The current if cense k&y is vzlid. , 
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FIGURE 34. License Key: View 

This pane displays characteristics of the current, active license key. 
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License Key: Upload 



License K*y: Update 
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FIGURE 35. License Key: Upload 
This pane allows for the installation of a new LiquiFire license key. 

When a new key is available, typically sent by LiquidPixels to the customer via e- 
mail, it can be simply installed via this pane. 
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Server Control: Start/Stop 



| Server Control: Start/Stdp/fcestart [1 




; ml 




[Restart|[stop|j Start) 1 



Server Control: Start/ Stop 

When changes are made to LiquiFire s configuration, the running server must be 
restarted for those changes to take affect. This pane can additionally be used to stop 
the server compledy, or start a stopped server. 

Command Description 

Restart Restarts the LiquiFire Server, incorporating any changes which have 

been updated in the configuration 

Stop Stops the LiquiFire Server 

Start Starts the LiquiFire Server 
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Server Control: Update Config 

Once changes to LiquiFire have been completed, the server's active configuration 
must be updated to reflect the changes. This pane performs that function, and will 
additionally eMail the current configuration to the server administrator. 
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Monitoring 



The monitoring section is used to observe and analyze overall LiquiFire perfor- 
mance. This includes overall system status, performance statistics, and requess access 
log. 




FIGURE 36. Monitor Section 



LiquiFire Orb provides several tools which can be used to asses current or past per- 
formance of a LiquiFire server or cluster. These tools can be used to simply observe 
current activity, to analyze the detailed information LiquiFire maintains for each Job 
run, or to compute usage and performance statistics for a period of time. 

Monitoring provides two areas: 

• Metering: Monitor current performance and server characteristics 

• Activity: Analyze detailed Job information 
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Metering: System Status 



Mttering: System Status 
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FIGURE 37. Metering: System Status 

This pane, within its four sections, displays an overview of the LiquiFire system. 
Should any of the indicators change to yellow or red, contact LiquidPixels support. 

Each of the five LiquiFire subsystems and their respective status, red or green, are 
displayed under the first section, System Status. Should a serious problem arise, it is 
possible that one or more of the subsystems will ceace to operate, and this informa- 
tion will be useful to pinpoint the problem area, in concert with LiquidPixels sup- 
port. 

Under the Load section, each member in the Cluster will be listed, along with an 
active bar-graph depicting the current server load for that node. These graphs are 
updated every 30 seconds, while this pane is displayed. 

Disk space is monitored in the Filesystems section, with an active bar-graph for each 
of the active disk areas in use. 

Finally the System Information section displays LiquiFire software version, Licens- 
ing information (and an expiry warning, as the end of a licence term draws near) as 
well as a count of server operating time. 
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Metering: Statistics 



Metering: 




Last Hinatfci 
Last 10 Minutest 
last Hour: 
Last Day; 
UttWeefc 



beefiest 



0 
10 
I4S 



mum tm 




$£34 Sj&JS I 

SC371 8 JO! j 

DJ24 OAR] 
0J3OP I 



{qmr? tsok 10§ secerns.) 



figure 38. Metering Statistics 

LiquiFire collects and maintains various statistics of its performance during opera- 
tion. 

The top portion of this pane provides an overview of recent cluster performance. For 
each of five timeframes, this area indicates the number of rendering requests (which 
excludes any requests which are handled by the LiquiFire result cache), the number 
of pixels served, and the standard-deviation of response time. This last field can pro- 
vide some overall feeling for performance; if this number becomes large* relative to 
its value for all time, available in the lower portion of the pane, it may indicate 
larger- than-normal requests, or some other performance limiting behavior is occur- 
ing. 

The lower portion of this pane provides performance metrics for a liquiFire cluster, 
broken down by virtual host. Each virtual host indicates the average render response 
time and standard-deviation for all time. 
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Activity: Access Log 
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figure 39. Activity: Access Log 

LiquiFire maintains two logs: a simple log of each request, and detailed transaction 
information for each request. The simple request log is maintained indefinately, 
while the details are maintained for 24 hours. This pane provides access to this col- 
lection of information. 

The pane above allows the user to select which elements of a log they wish to view. 
Each field is optional; multiple fields are combined as a logical and. Strings and por- 
tions of strings may be entered in any field. 

Once the form is submitted, LiquiFire Orb will present a pane containing a list of 
requests matching the criteria, as illustrated in Figure 40. 
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FIGURE 40. Activity: Access Log Request Listing 

Each line represents a request to LiquiFire, and is displayed along with its JobID, the 
date and time of the request, the node within the cluster that handled the request, 
and the IP address of the client making the request. Clicking on the JobID of a 
request will display additional detailed information, as illustrated in Figure 41. 
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FIGURE 41, Activity: Access Log Details 

This pane contains the request, JobID, Date and Time, and detailed execution infor- 
mation for each stage of processing. 
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Maintain 



The maintain section provides a convinent and powerful interface to LiquiFire s res- 
ident asset and cache areas. Through this section, files within a LiquiFire server or 
cluster may be fully manipulated, including archiving and editing. 




FIGURE 42. Maintain Section 



LiquiFire Orbs Maintan section provides all tools necessary to navigate the resident 
files, to add, delete, rename, and view artwork, chains, and fonts. 

Monitoring provides three areas: 

• Resident Assets: Manage the LiquiFire resident assets 

• Render Cache: Inspect or purge render cache items 

• Asset Cache: Inspect or purge asset cache items 

If the LiquiFire server is operating within a clustered environment, a fourth area 
appears: 

• Cluster: Manages cluster member synchronization 
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Resident Assets 



As with a typical filesystem, the LiquiFire asset pool can be organized via subdirecto- 
ries, and provides typical file-manipulation tools such as rename, delete, view, 
upload, etc. 

Within the Maintain section of Orb, the three Resident asset areas can be accessed 
by choosing the desired section. A typical view of the art section may present a pane 
similar to that in Figure 43. 




Action Size 
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FIGURE 43. Resident Assets: Art 



The top of the pane indicates which asset pool is being viewed, as well as the path or 
current folder; the root or 7* folder of the Art pool is being viewed above. 

Above the list of files are displayed a suite of icons, representing the globally-accessa- 
ble tools which may be used within this asset pool. The tools that may be available 
include: 



Command Description 



New Folder 

Create a new Folder (directory) within the currently displayed Folder. 
New File 

Create a new, empty file within the currently displayed Folder. Blank 
files may be subsequently edited via the edit command, see below. 

Upload File 

Upload a file or zip archive into the asset pool. Single files are simply 
added to the asset pool within the current Folder; zip archives' contents 
are un-zipped after the archive is transferred to LiquiFire. 



Beneath the column headings appear a list of files and folders, comprising the con- 
tents of the Asset pool being viewed. Just as the above commands apply generally to 
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the asset pool and Folder being viewed, the following commands apply specifically 
to the adjacent file. These commands include: 

Command Description 

Delete 

Clicking this icon will, after confirmation, remove the adjacent file 
permanently from the asset pool. 

View 

Display the item in the asset pool for inspection 
Rename 

Change the name of the item in the asset pool 
Edit 

Edit the item in the asset pool 
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Cluster: Synchronize 

When LiquiFire is operated as a cluster - cluster members have been added via "Liq- 
uiFire: Cluster" pane on page 30 - this pane becomes available. 

This pane allows for manual invocation of the cluster member synchronization pro- 
cess, normally performed automatically by the LiquiFire master server on a periodic 
basis. 
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FIGURE 44. Asset Cache: Synchronize 

Clicking the Sync button will initiate the cluster synchronization process. This pro- 
cess will assure that all cluster members have current copies of the most recent ver- 
sions of any resident assets. Depending on the number of members in the cluster 
and the number of assets, this process may take some time to complete. 
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FIGURE 45. Asset Cache: Synchronize Complete 

Upon completion, LiquiFire Orb will present the pane depicted in Figure 45, indi- 
cating which nodes participated in the synchronization process and how much data 
was transferred. 
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Rertder Cache: Flush Individual 



Render Cache; Flush Individual 
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FIGURE 46. Render Cache: Flush Individual 



As described in "Render Cache" on page 19, LiquiFire maintains a cached copy of 
each image it generates to increase performance. There may be situations where it is 
necessary to force LiquiFire to re-render an image within the Render Cache, 

Selecting the Flush Individual menu item within LiquiFire Orb brings up the pane 
illustrated in Figure 46. This pane allows a LiquiFire user to query the render cache, 
based on a regular expression, and selectively re-render the selected image. 
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FIGURE 47. Render Cache: Flush Individual Item List 



LiquiFire Orb will respond to the query by presenting a list of matching image 
chains which have corresponding rendered images currently resident in the Render 
Cache, similar to Figure 47. Clicking the delete icon 9 adjacent to a listed cache 
item will cause the currently stored rendered copy to be discarded and a new, fresh 
version to be generated in its place. 
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Render Cache: Flush All 

The entire contents of the LiquiFire Render Cache may be permanently removed, in 
its entirety, via the Flush ^//command. After confirmation, LiquiFire Orb will 
remove the entire contents of the Render Cache. This process may take a moment to 
complete, during which time LiquiFire will be unavailable. 
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Asset Cache: Validate 

As described in "Asset Cache" pane on page 1 9, LiquiFire maintains a cache of all 
assets requested via URL within an image chain. While LiquiFire will periodically 
(See "LiquiFire: Cache" on page 32.) validate the assets in cache against the original 
remote data, it may be necessary to initiate this process manually. 

Selecting the Validate menu item under the Asset Cache section will initiate this back- 
ground process. 
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Asset Cache: Flush Individual 
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FIGURE 48. Asset Cache: Flush Individual 

Similar to the Render Cache, selecting the Flush Individual menu item under the 
Asset Cache section within LiquiFire Orb brings up the pane illustrated in 
Figure 48. This pane allows a LiquiFire user to query the asset cache, based on a reg- 
ular expression, and selectively remove the selected asset. 
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FIGURE 49. Asset Cache: Flush Individual Item List 

LiquiFire Orb will respond to the query by presenting a list of matching assets 
(images, typefaces, color profiles, or chains) which are resident in the Asset Cache, 
similar to Figure 49. Clicking the delete icon S adjacent to a listed cache item will 
cause the currently stored copy to be discarded. Clicking the view icon * adjacent 
to a listed cache item will display that item. 
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Asset Cache: Flush All 

The complete contents of the LiquiFire Asset Cache may be permanently removed, 
via the Flush v4// command under the Asset Cache section. After confirmation, Liq- 
uiFire Orb will remove the entire contents of the Asset Cache. This process may take 
a moment to complete. 
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Tools 



Tools: Explorer 

LiquiFire Explorer provides a simple, yet powerful way to develop LiquiFire image 
chains within an assisted, interactive framework. As well, for efficiency, Explorer is 
integrated into other areas of Orb. 

LiquiFire Explorer encompases only a single pane within Orb, illustrated in 
Figure 50: 
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FIGURE 50. Tools: Explorer 

Within this pane are two sections: A large text edit box, and a button bar, below. 
Image chain design and editing takes place within the edit box while the button bar 
encompases Explorers command set. The commands available are: 



Command Description 



m 



Ckear 

Clears the contents of the the chain design area 
Examples 

Presents the Asset pool Folder containing example chains 
Fixup 

When pasting a chain from a web page into Explorer, this command 
can be used to convert the chain into an editable form, as well as to 
clean up common mistakes such as repeated & characters, etc. 
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Command Description 



w 



C ° Py 

Copies the chain in the design area into the 'chainboard' 
Paste 

Pastes the chain on the 'chainboard' into the design area 
Check 

Performs syntax checking and vaildation on the chain in the design 
area. 

View 

Submits the chain in the design area to the LiquiFire server (or cluster) 
configured in the Config area of LiquiFire Orb for preview. 



Chains are entered into the design area as a list of separate commands, separated by 
carriage returns. It is unnecessary to perform any X-URL-ENCODING of the chain in 
the design area, as Explorer will properly escape the chain before submission to Liq- 
uiFire for rendering when View is selected. Figure 51 depicts a chain properly 
formed for Explorer. 



Tools; Expk>r*r 
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FIGURE 51. Example Explorer Chain 

Notice in this example, the space in the text argument is written simply as a space, 
not as the X-URL-ENCODED %20 or shorthand V - Explorer handles this translation 
for you automatically. 
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Clicking on the View icon will open a new browser window containing a ren- 
dered version of the chain in the design area, if successful, or an appropriate error 
message, if unsuccessful. 




Hello Again 



FIGURE 52, Explorer Preview Window 



Clicking the Check icon will open a new browser window containing a syntax- 
hilighted form of the chain in the design area, along with any detected syntax or val- 
idation errors detected. This can be immencely useful when developing image 
chains. 
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FIGURE 53. Explorer Check Windows 



1 . Using the Preferences menu item under the Tools view, you may optionally choose to have image pre- 
views appear in the same browser window as Explorer. 
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Tools: Font Map 



Tools: Font Map 
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FIGURE 54. Tools: Font Map 

LiquiFire allows for access to full font character sets via Unicode character expres- 
sion. While this capability allows the user to express any character within a request, 
the vast Unicode character definitions still need to be known to properly identify the 
character desired. 



The Font Map tool displays a specified section of the Unicode character definitions 
as a table of glyphs (characters), rendered in a specified installed typeface. 
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Tools: Chain Cipher 



Tools: Chain Cipher 
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FIGURE 55. Tools: Chain Cipher 



As discussed in "Security" on page 17, LiquiFire allows for two modes to restrict 
access to a LiquiFire server: Refering Host, and Keyed Requests. For the Keyed 
Requests method, each chain is augmented with a request-specific key, without 
which the request will not render. Further, since this key is generated from the 
request itself, any alterations made to the request will cause the chain to not render. 

Within the Keyed Requests mechanism, there are two types of keys that may be gen- 
erated. A simple hash and a more sophisticated cryptographical cipher. The cipher 
method is available for the truely paranoid. 

This tool will generate the key for a particular image chain entered above. As in 
Explorer, chains are entered as separate lines. 
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T.H,ts:Ch.,i„ Cipher 
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FIGURE 56. Tools: Chain Cipher Hash 

When either the Hash or Cipher buttons are pressed, as illustrated in Figure 56, an 
encoded version of the chain will appear in a new text area below the original chain 
within the pane. This new version will additionally have the proper key attached. 
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Tools: Preferences 
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FIGURE 57. Tools: Preferences 

LiquiFire Orb has a few preferences which may be controlled by each individual Orb 
user. These preferences are maintained via a browser cookie, and will be persistant 
within a particular browser as long as the cookie exists. 



Field 



Description 



Preview window When developing image chains which result in transparent images, 
background it may be desireable to control the background color on which the 

image is displayed. This option allows you to set the background 

color of the view window. 

Show JobID When debugging a complex chain, this option may be enabled to 

cause LiquiFire to render the Job ID onto the rendered image. This 
ID can then be used within the Access Log section within the 
Monitor view to see detailed job processing information. 

Preview opens When enabled, LiquiFire Orb will display the rendered image in a 
separate window new separate window. 

Explorer window Allows you to set the size of the Explorer pane's design area, 
dimensions 

Orb UI Theme Allows you to choose from any of the installed UI themes for the 
entire Orb environment. 



CHAPTER 3 Real World Examples 



This chapter contains several complete examples of LiquiFire imaging, represented 
as HTTP requests. 

They may be simply illustrative, or may serve as a starting point for further chain 
development and experimentation. 
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Format Using LiquiFire, a single image can easily be re-purposed on-demand. Here, the 

Conversion image, a JPEG on the server, is delivered as JPEG: 

source=url [http: //www. liquidpixels . net /images /truf f . jpg] & 
scale=size[50%] & 
sink= format [ jpg] 




and now as GIF: 

source=url [http: / /www. liquidpixels .net /images /truf f . jpg] & 

scale=size[50%]& 

sink= format [gif ] 
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Some browsers can display BMP format Images: 

source=url [http: //www. liquidpixels . ne t / images It ruff . jpg] & 
scale=size [50%] & 
sink=format [bmp] 




And, as needs and formats evolve, re-purposing existing image assets is as simple as 
changing the URL. Formats like Adobe PDF, Group 3 Facsimile, and Tagged Image 
File Format (TIFF) are supported: 

source=url [http: / /www. liquidpixels .net /images /truff . jpg] & 

scale=size[50%]& 

sink= format [pdf ] 

SOurce=url [http: //www. liquidpixels .net/ images /truff . jpg] & 
scale=size [50%] & 
sink= format [g3fax] 

source=url [ ht tp : / /www . liquidpixel s . net / images / truff . j pg ] & 
scale=size [50%] & 
sink= format [tiff ] 
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Image Scaling The same high-resolution image asset can be presented as a scaled thumbnail: 



source=url [http: //www. liquidpixels.net/images/truff.jpg] & 
scale=size [128] & 

sink= format [ jpgj 




aiiiiiiii 



.or as a tiny image icon: 



source=url [http : / /www . liquidpixels . net / images/ truff . jpg] & 

scale=size[64]& 

sink=f ormat [ jpg] 
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ComplCX Scaling Scaling in LiquiFire can be specified in several ways. Here, we use the 'fit to square' 

method, asking that the source image be scaled such that it fits exactly within a 
128 x 128 pixel square. This approach allows images of any aspect-ratio to be easily 
handled, letting LiquiFire deal with the complex calculations necessary. And its so 
simple to add a border too: 



source=url [http: / /www. liquidpixels .net /images/ truf f . jpg] , 

name [img] & 
scale=size [1281& 

blank=width[128] # height [128] , color [grey80] ,name[bg]& 
border =width [3] , height [2] , color [ slat eblue] & 
composite=compose[Over] , image [ img ] , gravity [Center] & 
sink=f ormat [ jpg] 




Perhaps the thumbnail should be labeled: 

source=url [http: / /www. liquidpixels . net/ images/ truf f . jpg] , 

name [img] & 
scale=size[128] & 

blank=width[128] , height [128] , color [greySO ] ,name[bg]& 
border=width[2] , height [2] , color [slateblue] & 
compos ite=compose [Over] , image [img] , gravity [Center] & 
annotate=text [My+Kitty] , font [Arial-Bold] , 

pointsize[14] , gravity [South] ,y[-5J& 
sink= format [jpg] 
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And of course, the background could be an image as well: 

source=url [http: //www. liquidpixels.net/images/truff . jpg] , 

name [img] & 
scale=size [128] & 

border =width [2] , height [2] , color [black] & 

source=url [http://www.liguidpixels.net/images/SlideMount.jpg] , 

name [mount] & 
scale=size[200] & 

cornposite=compose [Over] , image [img] , gravity [Center] & 
annotate=text [My+Kitty] , font [Arial -Bold] , pointsize [14] , 

gravity [South] ,y[-15]& 
s ink= format C j pg 3 



o 




; O 



My Kitty 
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Vector-based Source images in vector formats, such as Encapsulated PostScript (EPS), PostScript 

Formats °r Scalable Vector Graphics (svg) are supported by LiquiFire. Since the conver- 

sion to pixels is not done until a pixel-manipulation command is encountered, scal- 
ing or rotation can be done without introducing any artifacts, or j aggies, in the 
resulting image: 

source=url [ f ile : Hands . eps] & 
sink= format [GIF] 




source=url [file : Hands . eps ] & 

scale=sxze[200%]& 

sink= format [GIF] 




source=url [ file: Hands .eps] & 

scale=size[300%]& 

sink=f ormat [GIF] 
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Dynamic Graphic By using LiquiFire to generate images on-demand, repetitive tasks are no longer 
Elements needed, saving valuable time and resources. Changing design elements such as text, 

typeface, size, color, or position no longer requires a trip to an image editing pack- 
age. Even foreign language translation is merely a URL change. 

source=url [file : tab . eps 3 & 

annotate=font [Arial-Roman] , pointsize [9] , text [Click+Me] , 

gravity [Center] , fill [black] & 
sink= format [GIF] 




source=url [ f ile : tab . eps ] & 

annotate=font [Arial-Bold] , pointsize [ 9 ] , text [No+Me] , 

gravity [Center] , fill [black] & 
sink= format [GIF] 




source=url [ f ile : tab . eps ] & 
hue=value [10] & 

annotate=f ont [Arial-Roman] , pointsize [9] , text [Click+Me] , 

gravity [Center] , fill [black] & 
sink= format [GIF] 




source=url [file : tab . eps ] & 
hue= value [40] & 

annotate= font [Arial-Roman] .pointsize [9] , text [Click+Me] , 

gravity [Center] , fill [black] & 
sink=f ormat [GIF] 
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Complex 
Calculations 



Here, a complex LiquiFire request is encapsulated in a stored chain (See "Stored 
Chains" on page 8.). This allows dynamic information such as the region, color, tar- 
get date, and holiday to be specified in the URL, while maintaining the look and 
logic of the banner in a small file on your site: 

set=key[a] , value [nyc]& 
set =key [color] , value [aquamarine ]& 
set=key[date] , value [2/14/2002] & 
set=key [hday ] , value [Valentine ' s+Day ] & 
load=url [f ile : vdaybanneradj . saran] 



c 



ii %$ 



(and the loaded file vdaybanneradj. saran contains:) 

regexcase=key [global .a] , cases [nyc | sfo | bos] , 

values [nycbg. jpg | sf obg . jpg | bosbg. jpg] /nametbg] & 
regexcase=key [global .a] , cases [nyc| sfo | bos] , 

values [ vl . gif | v2 . gif | vl . gif ] , name [heart ] & 
regexcase=key [global .a] , cases [nyc | sfo | bos] , 

values [vlb.gif | v2b.gif | v2 .gif] , name [hearto] & 
source=url [http: //www. liquidpixels .net /images /global .bg] , 

name [bg] & 

source=url [http: //www. liquidpixels .net /images/ 
global .heart] , 
name [hon] & 

source=url [http: //www. liquidpixels .net /images/ 
global. hearto] , 
name[hoff ]& 
select=name [bg] & 

fontmetrics=text [global .vday] , font [Dominican] ,pointsize [36] 
& 

attribute=name [bg] , key [delay] , value [30] & 
annotate=text [Only] , font [Dominican] , pointsize [22 ] , 

fill [global. color] ,y[353 ,x[10]& 
annotate=text [days+lef t+till+global .hday] , font [Dominican] , 

pointsize [22] , fill [global . color] ,y[35] ,x[117]& 
countdown=target [global . date] , key [vday] & 
annotate=text [global. vday] , font [Dominican] , pointsize [36] , 

fill [global. color] ,y[36] ,x[ ( 95-bg .metrics .x/2 ) ] & 
compos ite=compose [over] , image [ ho f f ] ,x[386]& 
addframe=image[honL delay [3 0] ,x[386] , trans [%23000000] & 
optimized 

s ink= format [gif ] , loop [forever] 
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Complex Imaging Complex imaging tasks are possible with LiquiFire, just as in any desktop imaging 

application. Here, a mask image is created from the word 'Hello,' through which the 
cat image is revealed: 



blank=width[40Q] , height [400 ] ,name[c] , color [skyblue] & 
text=text [Hello] ,pad[10] , bgcolor [white] , fill [black] , 

font [Arial-Bold] ,pointsize [100] , gravity [Center] ,name[t]& 
source=url [http: //www. liquidpixels .net/ images /truff . jpg] , 

name [cat 3 & 
scale=width[t .width] .height [t .height ]& 
at tribute=key [matte] , value [true] & 
composite=compose[replacematte] , image [t] & 
select=name[c]& 

composite=compose [over] , image [cat] ,x[ (c .width/2-t .width/ 

y [ (c.height/2-t. height/2) ] & 
sink 
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Simple Text While HTML formatting capabilities are limiting, LiquiFire can create graphic text 

elements on-demand, allowing your design intent - typeface, color, size - to be pre- 
serverd. All without the time and effort of creating a pile of graphics in a desktop 
application. 



text=font [Arial-Italic] ,pointsize [24] , f ill [DarkGreen] , 

text [Hello+Again] & 
sink^format [gif ] 



Hello Again 



Text can be rendered on a transparent background, if the format supports transpar- 
ency: 

text=font [Arial-Italic] ,pointsize [24] , f ill [DarkGreen] , 

text [Hello+Again] & 
transparent=color [%23FFFFFF] & 
sink-format [gif] 



Hello Again 



.any typeface, any size, any color: 

text= font [Bud+ Hand] , pointsize [24] , fill [DarkBlue] , 

text [Hello+Again] & 
sink=format [gif] 
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Text can be aligned to an image: 

blank=width[300] ,height[300] , color [DarkBlue] & 
annotate=font [Bud+Hand] # pointsize [24] , fill [Yellow] , 

text [Hello+Again] , gravity [East] & 
sink=format [gif ] 



Hello fjfiO-in 



.. .or fit to the size of an image: 

blank=width[300] , height [300] , color [DarkBlue] & 
annotate=font [Bud+Hand] ,pointsize [Fit ] , fill [Yellow] , 

text [Hello+Again] & 
sink= format [gif] 
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Source Commands blank 



Aliases 

new 



Description 

Creates a new image and adds it to the image pool. A new, solid image is created at 
the size specified, filled with the specified background color. 



Arguments 



Argument Type Description 

name string Optional. 

The name of the image within the image pool. If omitted, 
the images is assumed to be the current image. 

width number Required. 

The width, in pixels, of the new image 
height number Required. 

The height, in pixels, of the new image 
color color Default: white 

The color for the new image 
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u 

H 

HI 



Example 

blank=width[100] , height [50] , color [DarkBlue] & 
sink= format [gif ] 
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source 

Aliases 

src 

Description 

Acquires an image from the specified source and places it in the image pool for use 
later in a request. Images may be acquired from any of the supported sources, and 
may be in any of the supported formats. 

Images can be acquired from http : / /, f tp : / /, or f ile : sources. Images 
retrieved from remote sources are cached within LiquiFire. 

Images are maintained in LiquiFire's cache once retrieved; caching can be pre- 
vented by specifying the nocache [true] argument to the source command. 
Cache characteristics can be adjusted via the LiquiFire Orb. See "LiquiFire: 
Cache" on page 32. 

Arguments 

Argument Type Description 

url Required. 

Describes the source for the image data. 

URLs can be any valid form for the method indicated. For 
HTTP or FTP, username and password may be supplied, 
if required as illustrated in the examples below 

name string Optional. 

The name of the image within the image pool. If omitted, 
the images is assumed to be the current image. 

nocache truelfalse Default: False 

If True, the image is not stored in the LiquiFire caching 
system and will subsequently re-retrieved from the url 
specified in later requests. 

Example 

source=url [http : //www. liquidpixels . ne t/ Test Images /truff . jpg] & 
sink 
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Images may be directly retrieved from an FTP server, as well. In this example, the 
user auser and password mypas sword are used to access the FTP server at 
ftp.liquidpixels.net. 

source=url [ftp: //auser :mypassword@f tp.liquidpixels.net/ 

Tes t Image s/Erika . jpg] & 
scale=size[400] & 
sink 
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select 



Description 

Makes the named image the current image ('_')» replacing the previous current 
image. Can also be used to select a single frame from a multiple-frame image for 
manipulation. 



Arguments 
Argument Type 



string 



frame number 



Description 



Required. 

The name of the image within the image pool to be 
selected as the current image. 

Optional. 

If specified, the frame indicated is identified as the active 
frame, and will solely be affected by subsequent image 
manipulations. To re-select the entire image, use the select 
command without the frame argument specified. Frames 
are counted from 0. 



^2 5 



Example 

We add 2 images into the image pool. First, a large TIFF image, Fencs . tif 
(3340 X 2259; 22.6MB) given the name 'fence', and second a JFIF image, 
truff . jpg, which is left unnamed (as the current image). The select command 
makes the Fence . cif image the current image allowing the subsequent scale 
and sink commands to operate on it. 
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source=url [http : / /www . liquidpixels . net / images /Fence . tif ] 
name [fence] & 

source=url [ file : /home/marcs/Testlmages/ truff.jpg] & 
select =name [ fence] & 
scale=size [300x300] & 
s ink= format [j peg] 




5 



Example 

Given an eight frame GIF-89 (animated GIF) image, select and display frame 
number 2. Notice that while selecting a frame from an image, the image nam 
must be supplied: 



fll 

r: 



source=url [http: //www. liquidpixels . net /Testlmages /colors . gif ] & 
select=name [_J ,frame[2]& 
sink=format [gif ] 
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Sink Commands sink 

Description 

Sends the resulting image to the caller. 

Arguments 

Argument Type Description 

format any format Default: JPEG (J FIF). 

supported by Determines the format of the returned image. 

LiquiFire 

quality number Optional for JPEG-compressed formats only. 

Determines the JPEG setting 

loop number Optional for GIF-89. 

Sets the number of loops for animated GIF (GIF-89) 
images 

Example 

The sink command directs LiquiFire to send the image to the client. In the 5 fol- 
lowing examples, the request is identical except the sink command, with the sink 
command used for each image printed below the result. 

source=url [http: //www. liquidpixels.net/images/Fence.tif 3 / 

name [ fence ] & 
scale=size [ 600x600 ]& 
sink=format [jpeg] , quality [5] 




sink= format [jpeg] , quality [5] sink=f ormat [ jpeg] , quality [25] 

13,164 bytes 26,910 bytes 
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Imaging addframe 
Commands 

Description 

Adds the specified image as a new frame of the current image. The sub-image loca- 
tion, disposal, transparency, and delay characteristics for the added frame can be 
controlled via optional arguments. 

Arguments 

Argument Type Description 

image string Required. 

The name of the image in the pool to add as a new frame 

x number Required. 

The horizontal location of the top corner of the new 
frame, relative to the curtent image's left edge 

y number Required. 

The vertical location of the top corner of the new frame, 
relative to the current images top edge 

trans color Optional for GIF-89 and PNG 

If specified, the color is treated as transparent 

delay number Optional for GIF-89 and PNG 

Determines the delay in tenths of seconds between frames 
when the image is viewed as an animation. 

dispose nonelasisl Default: as is for GIF-89 

background! £) eterm i nes tne qj^ disposal method after the frame is 
P revious displayed. 

asis: the frame stays in place after display 
background: the frame is treated as the background 
for the subsequent frame 

previous: the previous frame is displayed after this one 
none: unspecified; continuous animation frame 

Example 

In this example, we will create a simple four frame animation. On a black back- 
ground image, we will add three frames, each at a new location. The disposal is set 
to background, causing the black background to be the basis for subsequent 
frames, rather than leaving the frame in place. 



81 




LiquiFire User's Guide: Base Command Set 



blank=width[100] , height [100] , color [black] ,name[bg]& 
blank=width[50] ,height[50] ,color[red] ,name[r]& 
blank=width[50] , height [50] , color [green] ,name[g]& 
blank=width[50] , height [ 50 ] # color [blue] , name [b]& 
select=name [bg] & 

attribute=name[bg] , key [delay] , value [70] & 

addf rame= image [r] , delay [10] ,x[0] ,y [25] , dispose [background] & 
addframe=image[g] , delay [10] , x[25] ,y[25] , dispose [background] & 
addframe=image[b] ,delay[10] ,x[50] ,y[25J , dispose [background] & 
optimize& 

s ink= format [gif] , loop [forever] 
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addprofile 

Description 

Embed or apply an ICC Color profile to an image. 

If the image does not contain an embedded color profile, addprofile will mark 
the image with the source profile specified. If a profile is embedded, addpr o file 
will perform the color transformation into the result colorspace specified by the 
profile given, and embed the profile in the image. 



O 

Q 



Arguments 

Argument Type 



url 



intent 



url 



Description 



Saturation! 
Perceptual! 
Absolutel 
Relative 



Required. — 

The url of the ICC profile to add. 

Color profiles referenced with the file : method must 
reside within the art directory on LiquiFire. See 
"Resident Assets" on page 46. 

Optional. 

If present, instructs the color management engine as to 
the color matching intent desired. 



Example 

Certain file formats can represent images in colorspaces which are unsuitable for 
output. For example, JFIF images can be represented in CMYK colorspace, result- 
ing in strange patterns if displayed on a web browser. By embedding a CMYK col- 
orspace source profile and adding a suitable RGB colorspace profile, the image can 
be displayed. 

source=url [http://www.liquidpixels.net/images/colors.jpg] 

addprofile=url[file:profiles/GenericCMYK.icm] 

addprofile=url[file:profiles/sRGB.icm] 

sink 



See 

"removeprofile" on page 131. 
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alphafill 

Description 

Fill a region of an images alpha channel. Since alpha channels are monochrome, 
the channel is filled with the intensity of the color specified. 

Arguments 

Argument Type Description 

x number Required. ~ 




7 



color 



color 



number 



The horizontal location at which to begin pouring ink 
Required. 

The vertical location at which to begin pouring ink. 
Required. 

The color to flood the image. 



Example 

See "fill" on page 114. 
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annotate 



Description 

Draw text on an image. 

Text may contain Unicode characters, expressed as Unnnn, where nnnn is a valid 
Unicode character value, or as extended characters, expressed as \nnn, where nnn 
is a valid ascii-extended character code. Unicode character codes may be explored 
using the Font Map tool in LiquiFire Orb. 

Multiple lines may be imaged together; line breaks may be expressed by \n within 
the text. 

Additional typefaces can be added to LiquiFire via FTP or LiquiFire Orb, or via 

URL. 



Arguments 



Argument Type 



Description 



text 



font 



pointsize 



stroke 



fill 



string Required. ~~ ~~ 

The text to be imaged 
fonmame Required. 

The name or URL of the typeface in which ro image the 
text. If a URL is provided, the typeface is retrieved and 
cached in the LiquiFire asset pool, 
numberl fit Required. 

Either the size, in points, of the text to be rendered, or the 
keyword fit, indicating the text size should be chosen such 
that the text fits within the size of the current image. 
Additionally, width and height can be specified to specify 
alternative boundaries to the pointsize. 

color Optional. 

If present, the text is outlined in this color, 
color Default: Black. 

Determines the color for the text 
color Optional 

If present, fills behind the text with a solid box in the 
specified color 
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Argument Type 



Description 



>{|SSij' 

p 



:: : 
'sis::? 



gravity 



alignto 



y 

width 



height 



rotate 



NorthWestl 
Northl 
NorthEastl 
Eastl 

SouthEastl 

South! 

SouthWestl 

Westl 

Center 

TopLeftl 

TopCenteri 

TopRightf 

Left! 

Center! 

Rightl 

BottomLeftl 

BottomCente 

rl 

BottomRight 
number 



number 
number 



number 



number 



Optional. 

Determines the origin from which the baseline of the text 
is positioned, relative to the current image 



Optional. 

If present, along with x and y arguments, the text is 
aligned at the point specified, aligned as specified to that 
point. 



The horizontal offset for the text baseline. If a gravity is 
specified, the origin for x and y is based on that location. 
Otherwise x and y specify absolute location within the 
image 

The vertical offset for the text baseline. See x for details. 
Optional. 

If pointsize is fit and this argument is present, the 
pointsize is selected such that the rendered text is no wider 
than width pixels. 

Optional. 

If pointsize is fit and this argument is present, the 
pointsize is selected such that the rendered text is no taller 
than height pixels. 

Optional 

If present, text will be drawn rotated the specified number 
of degrees clockwise. 



Example 

A simple example: Notice the text is barely visible at the top-left of the image. 
Since no x, y, or gravity was specified, the baseline of the text is located at 
0,0- resulting in only the portion of the text below the baseline to be visible. 
The baseline s position within a typeface is determined by the typographer. 
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blank=width[50] , height [50] & 

annotate=text [Hello] .font [Arial -Roman] ,pointsize[12] ,y[10]& 
sink 

Hello 



Example 

With the addition of the gravity argument, the text is centered within the image. 

blank=width[50] .height [50] & 

annotate=text [Hello] , font [Arial -Roman] ,pointsize [12] , 

gravi ty [Center ]& 
sink 



Hello 



Example 

Text can be rendered at any angle. Here, we anchor the coordinates to the top cen- 
ter of the image with the gravity argument, then shift the text downward by 10 
pixels with the y argument: 

blank=width [50], height [ 5 0 ] & 

annotate=text [Hello] , font [Arial-Roman] , pointsize [12] , 

gravity [North] .rotate [45] ,y[10j & 
sink 
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attribute 



Description 



Sets (or clears) an image-metadata value. See Appendix, "Image Metadata Fields" 
on page 191 for a list of image-metadata fields and their semantics. 



\ I J 



Arguments 
Argument Type 



Description 



key string Required. " 

The name of the metadata field to be adjusted 

value any Optional. 

If present, contains the new value for the field specified. If 
omitted, the contents of the field are cleared to the default 
value specific to the field. 

name string Optional. 

If present, the attributes of the named image are altered. 



Example 

The attribute command is used here to set the inter-frame delay for the newly cre- 
ated background image to 30 tenths of a second. 

blank=width[50] ,height[50] , color [black] ,name [bg]& 
blank=width[25] .height [25] ,color[red] ,name[r]& 
select=name [bg] & 

attribute=name [bg] , key [delay] , value [30] & 
addframe=image[r] ,delay[30] ,x[12] # y[12]& 
optimized 

sink= format [gif] , loop [ forever] 





frame 1 



frame 2 
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bevel 

Description 

Applies a bevel effect to the edges of the image. 



iN 5 

SI 
H 



111 



Arguments 

Argument Type 



Description 



width number Default: 5 

The width, in pixels, of the left and right bevel edges 
height number Default: 5 

The height, in pixels, of the top and bottom bevel edges 

raise Boolean Default: false 

If true, shading on the bevel's edges is chosen to produce a 
raised appearance. Otherwise, a sunken bevel appearance 
is used. 

Example 

Some variations on the below example appear in the following table. 

source=url [http: / /www. liquidpixels .net / Tes t Image s/truf f . jpg] & 
scale=size [300x300] & 
bevel & 
sink 




bevel 



bevel =raise [true] 
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blur 

Description 

Blurs an image using a speed-optimized Gaussian blur. See "gblur" on page 123. 
Arguments 

Argument Type Description 

width number Required. ™ "~ 

The extent of the blurring from any point. 

sigma number Default: 1.0 

The amount of blurring to apply. 

Example 

source=url [http: / /www. liquidpixels . net /Test Images / truf f . jpg j & 
scale=size [300x300] & 
blur=width[2] , sigma [1. 0 3 & 
sink 




blur=width[2] , sigma [1.0] blur=width [4] , sigma [1 . 0] 
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border 

Description 

Applies a solid or tiled border to an image. 

Arguments 
Argument Type Description 

width number Required. — . — _ 

The width, in pixels, of the border 
height number Required. 

The height, in pixels, of the border 
color color Default: white 

The color of the border. See Appendix B: Color Name 
Definitions for defined color names. 

Example 

source=url [http: //www. liquidpixels .net /Test Images/ truff.jpg] & 

scale=size [3 00x300] & 

borders 

sink 




border=width[5] , height [5] border=color [DarkBlue] , 

width [5] , height [5] 
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brightness 

Description 

Adjusts brightness of an image 

Arguments 

Argument Type Description 

value number Required. 

The amount of brightness adjustment to apply. Brightness 
is represented as a percentage; brightness of 0 renders the 
image black, 100 results in no-change, and values greater 
than 100 increase brightness. 

Example 

source=url [http://www.liquidpixels.net/~marcs/TestImages/ 
truff.jpg] & 

scale=size [300x3 00] & 

brightness=value [50] & 

s ink=gual i ty [ 1 0 0 ] 




brightness=value [300] 
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colorize 

Description 

Tints the image with the color specified. 

Arguments 
Argument Type Description 

fill color Required. ~* — 

The color with which to tint the image. 

opacity number Default: 100 

Determines the amount of colorization to occur. Lower 
values permit most of the original image to show through, 
while higher values result in an image approaching a solid 
fill color. 

Example 

Colorize can be used as a special effect. Here, the fence image is colorized 25% 
with a strong blue tint: 

source=url [http: //www. liquidpixels . net/ images / Fence . tif ]& 

colorized ill [blue] , opacity [25] & 

sink 




Example 

Colorize can also be used to tint monochrome images. By first changing this image 
to grayscale by decreasing the saturation to 1, then applying a brown tint with 
colorize, we achieve the Sepiatone effect of aged photographs. 
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source=url [http : //www. liguidpixels . net /images /Fence . tif ] 
saturation=value [ 1 ] 
colorize=fill [tan3] ,opacity[35] 
sink 
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composite 

Description 

Composition, or layering, allows two images to be combined together. Two 
images are involved in composition: the current image and a new source image 
(the layered image) specified by the image argument. During the composition 
process, alpha channels (transparency information) in both the current image and 
the layered image may be involved in the combination process, depending on 
which compose operator is used. 

The two images are combined, pixel by pixel, according to the specific compose 
operator specified. The over compose operator is probably most commonly used; 
it performs image layering, blending the layered image to the current image based 
on the current images alpha channel. 



ry 



Arguments 
Argument Type 



Description 



compose 



image 



OverlXorl 

AddlSubtractl 

Bumpmapl 

Replace! 

ReplaceRedf 

ReplaceGreenl 

ReplaceBluel 

ReplaceAlphal 

Blendl 

Displace 

string 



Required. 

The type of composition to perfotm. 



Required. 

The name of the image in the image pool to use as the 
layered image. 
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Argument Type 



Description 



gravity 



opacity 



number 



number 



NorthWesti 
North! 
NorthEasti 
East! 

SouthEastl 
South I 
SouthWestl 
Westl Center 

number 



Optional. 

The horizontal offset, in pixels, of the layered image 
relative to the left edge of the current image. 

Optional. 

The vertical offset, in pixels, of the layered image relative 
to the rop edge of the current image. 

Optional. 

Determines the origin from which the origin of the 
composite image is positioned, relative to the current 
image e J. 



Optional, [nyi] 

Percentage of opacity to use during composition. 



Examples 

In the following examples, these two images and corresponding alpha channels are 
used: 




Layered Image 




Layered Image's Alpha Channel 




Current Image 



Current Image's Alpha Channel 
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These sample images are composited together below using the indicated compose 
operator. 




Over 

Renders the layered image, masked by the 
layered image s inverted alpha channel, 
layered with the current image, masked by 
the layered image's alpha channel 



red 
green 
blue 
alpha 



{ L[r] * (255 - L[Ct]) + C [r] * L[a] ) * 1/255 

( L[g] * (255 - L[a]) + C[g] * L[a] ) * 1/255 

( L[b] * (255 - L[a]) + C[b] * L[a] ) * 1/255 

( L[a] * (255 - L[Ot]) + c[a] * L[a] ) * 1/255 




Atop 

Renders the layered image masked by the 
current images alpha channel, combined 
with the current image, masked by the 
layered images alpha 



red 


= ( L[rj 




era] 


+ 


C[r] * 


( 255 


- Ma] ) 


) * 1/255 


green 


= ( L[g] 


* 


C[CC] 


+ 


C[g] * 


( 255 


- L[<X] ) 


* 1/255 


blue 


= ( L[b] 


* 


C[CC] 


+ 


c[b] * 


( 255 


- L[CC] ) 


* 1/255 


alpha 


= { L[a] 


* 


era] 


+ 


c[a] * 


( 255 


- L[a] ) 


) * 1/255 
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In 

Renders the layered image, masked by the 
current image s alpha channel 



{255 - CECX]) 

255 - C[a]) 

(255 - era]) 

(255 - C[a]) 



1/255 
1/255 
1/255 
1/255 




red = ( L[r] * C[a] ) 

green = ( L[g] * C[Ot] ) 

blue = { L[b] * C[<X] ) 

alpha = ( L[a] * C[CCJ ) 



Out 

Displays the layered image, masked by the 
current images inverted alpha channel 



1/255 
1/255 
1/255 
1/255 




Plus 

Renders the layered image arithmetically 
added to the current image. Channel values 
exceeding the allowed range are clipped to 
the maximum allowable level. 

(pixel values are clipped) 



red 
green 
blue 
alpha 



= L[r] + C[r] 

= L[g] + C[g] 

= L[b] + c[b] 

= L[a] + c[a] 
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Minus 

Renders the layered image arithmetically 
subtracted from the current image. Negative 
channel values are set to zero. 

(pixel values are clipped) 



red 


= L[r] 


- C[r] 


green 


- L[g] 


- C[g] 


blue 


= L[b] 


- C[b3 


alpha 


= L[CC] 


- c[a] 




Difference 

Renders the arithmetic difference (absolute 
value of the difference) between the current 
image and the layered image. 



red = absolute { L[r] - C[r] ) 

green = absolute { L[g] - C[g] ) 

blue = absolute ( L[b] - C [b] ) 

alpha = absolute ( L[a] - C[a] ) 




Xor 

Renders the layered image masked by the 
current image s alpha channel with the 
current image masked by the layered images 
alpha channel. 



red 
green 
blue 
alpha 



( L[r] * c[<X] + C[r] * L[CCJ ) * 1/255 

( L[r] * C[a] + C[r] * L[OC] ) * 1/255 

( L[r] * C[(X] + C[r] * L[a] ) * 1/255 

{ L[rj * C[a] + C[r] * L[a] ) * 1/255 
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red = brightness { L ) 

green = C [g] 

blue = C[b] 




red = c[r] 

green = brightness { L ) 

blue = C[b] 



ReplaceRed 

Replaces the current image s red channel 
with the brightness of the layered image. 



ReplaceGreen 

Replaces the current images green channel 
with the brightness of the layered image. 




red = c[r] 

green = c[g] 

blue = brightness { L ) 



ReplaceBlue 

Replaces the current images blue channel 
with the brightness of the layered image. 
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contrast 

Description 

Perform automatic image contrast optimization. 

Arguments 

Argument Type Description 

increase trueifalse Default: True. 

If true, the contrast is increased. If false, the contrast is 
decreased. 

Example 




Original contrast=increase[true] 
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crop 

Description 
Crop an image 

Arguments 

Argument Type 



Description 



width 



number 



height number 



number 



number 



Optional. 

Width, in pixels, of the image region to preserve. If 
omitted, the area from the horizontal offset x to the right 
edge of the image is preserved. 

Optional. 

Height, in pixels, of the image region to preserve. If 
omitted, the area from the vertical offset y to the bottom 
edge of the image is preserved. 

Default: 0 

Horizontal offset, in pixels, from the left edge of the 
image where cropping will begin. Any image area to the 
right of this value is preserved. 

Default: 0 

Vertical offset, in pixels, from the top edge of the image 
where cropping will begin. Any image area below this 
value is preserved. 



Example 

The original image: 
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Cropping 60 pixels from all sides, results in: 

source=url [ht tp : / /www . liquidpixel s . net / images / truf f . j pg ] & 
crop=x[60] ,y[60] , width [ (a. width- 120) ] , 

height [ (a.height-120) ]& 
sink 




107 



LiquiFire User's Guide: Base Command Set 



double 

Description 

Double the size of an image via linear interpolation. Linear interpolation is high 
speed, mediocre quality. See scale on page 137 for higher-quality alternatives. 

Arguments 

none 
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draw 

Description 

Draw arbitrary line-graphics onto an image. 



Arguments 
Argument Type 



Description 



primitive 



points 



stroke 

fill 

tile 



swidth 



line I 

rectangle! 
arciellipsel 
circlel 
polyline 1 
polygon! 
bezierl 
color 

poinrlist Required. 



color 
color 
string 

number 



Required. 

The name of the graphic element to draw. 



A space separated list of points appropriate for the 
primitive selected. Multiple instances of the same 
primitive can be imaged by specifying multiple sets of 
coordinates. 



Line: Sequence of x,y pairs 

Rectangle: Left, Top, Right, Bottom 

Start x Starty, Enc^, Endy, Bias start , Bias end 

Center x,y, x radius, y radius, start angle, end 
angle 

Centet x , Center^ Pointy Pointy 
Sequence of x,y points 
Sequence of x, y points. Polygons ate closed 
polylines. 

4 pairs of points, defining start, control j, 
control 2 , and end 

Stroke color 
Fill color 
Optional. 

Name of an image in the image pool to use as a pattern 
when drawing. 

Optional. 

width, in pixels, of strokes 



Arc: 
Ellipse: 

Circle: 

Polyline: 

Polygon: 

Bezier: 
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Argument Type Description 

translate pointlist Optional. 

X, Y offset at which drawing begins. 

scale number Optional. 

If present, coordinates in drawing operations are scaled by 
this factor. 

rotate number Optional. 

If present, drawing operations are rotated 
counterclockwise. 

skewx number Optional. 

If present, drawing operations are skewed in the 
horizontal direction 

skewy number Optional. 

If present, drawing operations are skewed in the vertical 
direction 



Example 
A few lines: 

blank=width [300], height [ 2 0 0 ] & 

draw=primitive[line] , points [20+50+280+50] , stroke [black] & 
draw=primitive[line] , points [20+70+280+70] , stroke [red] & 
draw=primitive[line] , points [20+90+280+90 ] , 

s tr oke [ purpl e ] , swidth [ 1 0 ] & 
sink 
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Arcs: 

blank=width[300] , height [200] & 

draw=primitive[arc] .points [150+100+50+70+50+50 ] , 

s troke [black] , swidth [ 2 ] & 
draw=primitive[arc] .points [150+100+200+90+20+20] , 

stroke [darkgreen] , swidth [2 ] & 
draw^primitive [arc] , points [150+100+200+40+40 + 2 0 J , 

stroke [purple] , swidth [3 3 & 
sink 




III Circles: 

| s js source=url [http: //www. liquidpixels.net/ images/ truff.jpg] , 
' m name [cat] & 

* blank=width[300] . height [200 ] & 

draw=primitive [circle] .points [150+100+10+100] , 
f|| stroke [black] .swidth [2] , tile [cat] & 

| c; ;., draw=primitive [circle] .points [150+100+170 + 100] , 
"k stroke [black] .swidth [2] , f ill [gray80] & 

*jP sink=format[gif ] 
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ellipses: 

blank=width[300] , height [200] & 

draw=primitive [ellipse] , points [150+100+60+70+0+360] , 

stroke [black] ,swidth[2] , f ill [gray80] & 
draw=primitive[ ell ipse] , points [150+100 + 60+70+290+360] , 

stroke [black] , swidth[2] & 
draw=primitive [ellipse] , points [130+70+15+10+0+360] , 

Stroke [darkgreen ] ,swidth[2] , fill [lavender] & 
draw=priraitive [ellipse] , points [170+70+15+10+0+360] , 

stroke [darkgreen] , swidth[2 J , fill [lavender] & 
draw=primitive [ellipse] , points [150+120+40+25+0+180] , 

stroke [purple] , swidth [3 ] & 
sink=format [gif ] 
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Affine Transformations: 

blank=width[300] , height [200] & 

draw=primitive [ellipse] , points [150+100 + 60+70 + 0+360] , 

stroke [black] ,swidth[2] , fill[gray80] , rotate [30 ] , 

translate [ 50+-50 ] & 
draw=primitive[ ellipse] , points [130+70+15+10+0+360] , 

stroke [darkgreen } , swidth[2] , fill [lavender] , rotate [30] , 

translate[50+-50] & 
draw=primitive [ellipse] .points [170+70+15+10+0+360] , 

stroke [darkgreen] , swidth[2] , fill [lavender] , rotate [30] , 

translate [50+-50]& 
draw=primitive[ ell ipse] , points [150+120+40+25+0+180] , 

stroke [purple] , swidth[3] , rotate [3 0] , translate [5 0+-50] & 
sink=f omaat [gif ] 
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fill 



I- 



Description 

Fill a region of an image to the nearest image border. 



Arguments 

Argument Type 



Description 



x number Required. ~~ 

The horizontal location at which to begin pouring ink. 
7 number Required. 

The vertical location at which to begin pouring ink. 
color color Required. 

The color to flood the image. 



ru 



1,1 



Example 

While the draw command provides powerful drawing primitives including con- 
trol over fill and stroke color, there are times when areas of an image must be 
painted by alternative means. Here, two interlocking circles form a shape which is 
filled with the f i 1 1 command. 

blank=width [300], height [ 1 5 0 ] , color [ skyblue ] 
draw=primitive [Cir- 
cle) , points [100+75+30+75] ,swidth[l] , stroke [black] 
draw=primitive [Cir- 
cle] .points [200+75+270+75] ,swidth[l] , stroke [black] 
fill=x[150] ,y[75] ,color[Red] 
sink= format [gif ] 
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filter 

Description 

Process an image through an image filter or special effect. 
Additional filters can be added to LiquiFire. 
Arguments 



Argument Type 



Description 



effect 



denoisel 

despecklel 

emboss! 

enhancel 

equalizel 

implode! 

invert! 

noisel 

normalize! 

paint! 

shade! 

sketch! 

solarizel 

spread! 

swirl 



Required. 

The name of the filter to be applied. 



level number Required. 

Determines the strength of the effect. This value has 
differing meanings for each filter. See Appendix,"Filter 
Control Values" on page 189 for specific filter semantics. 

alpha number Optional for certain effects. 

This value has differing meanings for each filter. See 
Appendix, "Filter Control Values" on page 189 for specific 
filter semantics. 

beta number Optional for certain effects. 

This value has differing meanings for each filter. See 
Appendix, "Filter Control Values" on page 189 for specific 
filter semantics. 
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Example 




filter=effect [Paint] , level [3] filter=ef feet [shade] , 

level [15] ,alpha[270] 




f ilter=ef f ect [sketch] , level [10] f ilter=ef feet [solarize] , 

level [50] 
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flipx 

Description 

Mirror an image along its X axis; vertically flip the image, top to bottom. 

Arguments 

none 

Example 
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flipy 

Description 

Mirror an image along its Y axis; horizontally flip the image, left to right. 

Arguments 

none 

Example 
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frame 



Description 

Create a beveled frame around an image, increasing the size of the image buy the 
size of the frame. 



Arguments 

Argument Type Description 

width number Default: 15 

Overall combined width, in pixels of each of the three 
bevel components 

height number Default: 15 

Overall combined height, in pixels of each of the three 
bevel components 

inner number Default: 5 

Number of pixels used for the lighter inner bevel 
outer number Default: 5 

Number of pixels used for the darker inner bevel 
color color Default: gray70 

Color of the frame 



Example 



source=url [http: //www. liquidpixels .net /images ft ruff . jpg] & 

frame=width[20] , height [20] , color [blue] & 

sink 
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grid 

Description 

Draw a grid of lines on an image. 

Grid spacing, color, thickness, and position can all be controlled. 



Arguments 
Argument Type 



step 



number 



xstep number 

ystep number 

color color 

swidth number 

x number 

y number 

width number 

height number 



Desctiption 



Default: 10 

If present, determines the spacing between the grid lines 
in both the vertical and horizontal direction. 

Optional. 

If present, independantly determines the spacing between 
the vertical grid lines. Overrides step. 

Optional. 

If present, independantly determines the spacing between 
the horizontal grid lines. Overrides step. 

Default: Black 

If present, determines the color of the grid lines. 
Default: 1 

If present, determines the thickness of the gridlines. 
Optional. 

If present, the grid will begin at the specified horizontal 
location on the image. 

Optional. 

If present, the grid will begin at the specified vertical 
location on the image. 

Optional. 

If present, the grid will end at the specified horizontal 
location on the image. 

Optional. 

If present, the grid will end at the specified vertical 
location on the image. 
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Example 

source=url [http: //www. liquidpixels . net /Test Images /truf f . jpg] 

scale=size[50%] 

grid=color [yellow] 

sink 
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gamma 

Description 

Apply a gamma correction curve to the image, or to one (or more) channels. 



Arguments 
Argument Type 



gamma number 



red 



blue 



number 



green number 



number 



Description 



Optional, One argument required. 

If present, the entire image is adjusted by the application 
of gamma correction 

Optional, One argument required. 

If present, the red channel is adjusted by the application 
of gamma correction 

Optional, One argument required. 

If present, the green channel is adjusted by the application 
of gamma correction 

Optional, One atgument required. 

If present, the blue channel is adjusted by the application 
of gamma correction 



La. 



Example 

source=url [http: / /www. licjui&pixels . net/Testlmages/truf f . jpg] 

scale=size[50%] 

gamma^gamma [2.0] 

sink 




gamma= gamma [2.0] 



gamma = gamma [0.6] 
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gblur 

Description 

Apply a Gaussian blurring to an image. 

When blurring an image, numerous options exist for the mechanism and nature 
of the blurring function. One such mechanism, called a Gaussian blur, attempts 
to blur the digital image much the way an optical lens would - symmetrically in all 
directions from any single point. The function enables the user to specify the 
amount of blur (sigma) and the extent of the blur from any point (radius). 

Arguments 

Argument Type Description 

width number Required. 

The extent of the blurring from any point, 
sigma number Default: 1.0 

The amount of blurring to apply. 

Example 

source=url [http : / /www. liquidpixels . net /Test Images /truff . jpg] & 
scale=size [300x3 00] & 
gblur=width [2] , sigma [1 . 0 ] & 
sink 




Original 
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half 

Description 

Halve the size of an image. Pixel halving is performed by linear interpolation - 
High speed, mediocre quality. See scale on page 137 for higher-quality alterna- 
tives. 

Arguments 

none 
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hue 

Description 

Adjusts hue (color) of an image 

Arguments 

Argument Type Description 

value number Required. 

0<n< 100 

The amount of hue adjustment, as a percentage of 360°, 
to apply. A value of 50 shifts colors 180°, a value of 100 
shifts colors 360°. 



Example 

source=url [http: / /www. liquidpixels . net /images / truf f . jpg] & 
scale=size [50%] & 
hue=value[20] & 
sink 
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layer 

Description 

Replace the current image or add a named image to the pool containing the chan- 
nel specified from the current image. The layer command replaces the original 
image data with a monochrome image from the selected channel. See the dupli- 
cate command to preserve the original image in the pool. 

Arguments 

Argument Type Description 

layer redlgreenl The name of the channel to select 

bluel alpha 

name string Optional; 

If omitted, the color channel specified is extracted and 
replaces the currentimage in the pool. If specified, the 
extracted layer is added to the pool under this name. 

Example 

To darken the green channel in an image (whch will appear as a magenta cast), the 
layer command and brightness commands are used: 

source=url [http: / /www. liquidpixels .net/images/ truff . jpg] , 

name [cat] & 
layer = layer [green] , name [greenchannel] & 
brightness=value [ 80 } & 
select=name [cat] & 

composite=compose [replaceGreen] , image [greenchannel ] & 
sink 
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optimize 

Description 

Adds format-specific optimizations from an image. 

Certain formats, such as GIF-89, are capable of presenting their image data as sev- 
eral frames, each with its own origin, color table, and size. The optimize com- 
mand identifies redundancies in the image and processes each frame to the 
smallest size possible, with the most efficient color table. 

Optimized images are difficult to manipulate, but are significantly smaller when 
transmitted. 

Arguments 

none 
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quantize 

Description 

Reduce the number of colors in an image by using stepwise quantization. 

Quantization maintains an even distribution of the image's colors while grouping 
them into evenly spaced clusters, and replaces the colors in the image with the 
average color of the cluster. 

Optionally, the quantize command can be used to convert the image from one 
colorspace to another, by specifying the colorspace argument. 

Arguments 

Argument Type Description 

colors number Required. 

The maximum number of colors in the new image 

dither Boolean Default: false 

If true, the image is dithered to appear as if more colors 
are in use. 

colorspace RGBIGrayl Optional 

?™^ a fl n il, The name of an alternative colorspace. 
OHTA1XYZI r 

YCbCrlYIQI 

YPbPrlYUV 



Example 

source=url [http: / /www. liquidpixels .net /images /truf f . jpg] , name [c]& 

quantize= colors [16] & 

sink 




quantize=colors [16] 



quantize=colors [8] , dither [true] 
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Ill 



removeprofile 

Description 

Removes all ICC profiles embedded in an image. 

Arguments 

None. 

See 

"addprofile" on page 83. 
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resize 

Description 

Scale an image, using a specific sampling algorithm. 
See "scale" on page 137. 

Arguments 

Argument Type Description 

size 



filter 



Relative Performance 



Filter 


Overhead 


Filter 


Overhead 


Point 


(baseline) 


Quadratic 


160% 


Box 


114% 


Mitchell 


160% 


Hamming 


128% 


Cubic 


162% 


Triangle 


128% 


Lanczos 


196% 


Hermite 


128% 


Cantrom 


197% 


Blackman 


129% 


Bessel 


206% 


Hanning 


132% 


Sine 


231% 


Gaussian 


136% 







TABLE I. Relative Filter Performance 



diml%labsSiz The desired size of the image. 



PointiBoxl 

Triangle! 

Hermitel 

Hanningl 

Hamming! 

Blackman! 

Gaussian! 

Quadratic! 

Cubic! 

Catroml 

Mitchelll 

Lanczos I 

BessellSinc 



Size can be specified as a percentage (n%), an enclosing 
rectangle (mxn). or an absolute size in pixels (mxnl) 

Default: point 

The name of the sampling algorithm to use. 
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roll 

Description 

Roll an image horizontally or vertically. 

Rolling an image shifts the content, replacing the original content with the por- 
tion of the image that fall outside the original image bounds. 



Q 

o 



Arguments 
Argument Type 



number 



number 



Description 



Optional. 

The horizontal displacement, in pixels. 
Optional. 

The vertical displacement, in pixels. 



Example 

By using the border command, in conjunction with the roll command and Liq- 
uiFire s ability to evaluate expressions, we can create a space for text annotations - 
regardless of the images size. 

source=url [http: //www. liquidpixels .net/ images /truf f . jpg] 

, name [cat] & 
border=height [20], width [ 1 ] & 
roll=y[ (cat. height- 19) ]& 

annotate=gravity [south] , font [Arial -Roman] , 

text [A+Cat] ,pointsize[14] ,y[-283& 
sink 




A Cat 
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rotate 



Description 

Rotate an image clockwise. 

Arguments 

Argument Type Description 

degrees number Required. 

The angle, in degrees. 

fill color Optional. 

If present, the triangles remaining are filled with this 
color when an image is rotated an amount other than 90° 
increments. 



Example 

source=url [http : / /www. liquidpixels . net / images /truff . jpg] & 
scale=size[50%] & 

rotate=degrees[38.5] , f ill [lightblue] & 
sink 
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source=url [http: //www. liquidpixels .net/ images /truf f . jpg] & 
scale=size[50%] & 
rotate=degrees [90] & 
sink 
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saturation 

Description 

Adjusts saturation of an image 

Arguments 

Argument Type Description 

value number Required. 

The amount of saturation adjustment to apply, 
represented as percent. A value of 0 will desaturate an 
image completely - converting it to grayscale; 100 
represents no change; values greater than 100 increase 
saturation. 

Example 




saturation=value[50] saturation=value [150] 
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scale 

Description 

Scale an image. Image dimensions can be specified in 4 ways: 



Mechanism 

a fixed target size 



an enclosing 
rectangle 



Format 

widthxheight! 

widthxheight 



an enclosing square side 

a percentage percent% 



Description 

In this mode, the image will be scaled to exactly the 
dimensions spedified. The image will be distorted 
from the original aspect ratio if necessary. 

In this mode, the image will be scaled to the 
maximum size possible within the specified 
dimensions, preserving the image's aspect ratio 

Shorthand; equivalent to an enclosing rectangle 
with equal sides 

The image will be decreased in size if the number is 
less than 100; increased for numbers greater than 
100. 



TABLE 2. Image Dimension Specification 



Arguments 

Argument Type 



Description 



SLze 



width 



height 



diml%l 
absSize! 



number 



number 



The desired size of the image. 

Size can be specified as a percentage (nn°/o), an enclosing 
rectangle (mmxnn). or an absolute size in pixels (mmxnn!) 

Optional. 

If present, the image is scaled to the specified width, in 
pixels. 

Optional. 

If present, the image is scaled to the specified width, in 
pixels. 



Example 

Here, we specify the scale size in enclosing square mode. The resulting image's 
aspect ratio is preserved with the larger size scaled to 400 pixels and the other such 
that the image is not stretched. 
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source=url [http : //www. liquidpixels .net /images /Fence . tif ] & 

scale=size [4003 & 

sink 




Fixed target size can be used to stretch images: 



source=url [http : / /www . liquidpixels . net / images / Fence .tif] 

scale=size [500x100 I ] 

sink 
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segment 

Description 

Perform color reduction by histogram analysis and similar-color clustering. Very 
accurate, Very computationally expensive (slow) 

Arguments 



Argument Type 



colorspace 



cluster 
smooth 



RGBIGray! 

Transparent! 

OHTAiXYZI 

YCbCriYIQI 

YPbPrlYUVl 

number 

number 



Description 



Optional. ~~ * 

If present, specifies new colorspace for the image. 

Note that, for non-direct conversion, profile-based color 
management is not employed during this conversion 

Weight to apply to color clusters 

Amount of smoothing applied to the histogram. Higher 
numbers result in fewer colors 



Example 



ru 




Original 




segment=smooth [0.2] 



s egment= smooth [0 . 5 ] 
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sharpen 



Description 

Apply sharpening with a laplacian kernel to an image. 
See also usharpmask on page 147. 



Arguments 

Argument Type 



Description 



radius 



sigma 



number 



number 



Required. 

The extent of the sharpening from any point. 
Default: 1.0 

The amount of sharpening to apply. 



Example 




Original 




sharpen=radius [ 1 ] , sigma [20] 



sharpen=radius [2] , sigma [20] 
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showid 

Description 

Images the JobID onto the image. This is useful when developing complex image 
chains as the JobID can be used in LiquiFire Orb to obtain additional detailed 
information about the processing of a job. 

Arguments 

None 

Example 

source=url[http: //www. liquidpixels.net/images/truff.jpg] 
scale=size[50%] 

showid 
sink 
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svg 



Description 

Manipulate Scalable Vector Graphics documents dynamically. 

Additional information about SVG can be found at 

h t to : / / www . w3 . org / 1'R/ 2001/ PR- SVG -2C010719/ index . html 



Arguments 
Argument Type 



id 



type 



value 



Description 



number Required. 

The id for the SVG element you which to alter. 

style Required 

The type of manipulation to perform. Currently only 
styles may be changed. 

string Required 

The new value for the attribute 



S : 



Example 

source=url [http : //www. liquidpixels . net /images /USA. svg] 

svg=type [style] ,id[NE] , value [ fill : teal; ] 

sink 
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threshold 



Description 

Convert an image to monochrome via intensity thresholding. 

The image is first converted to greyscale (more accurady, the intensity of each 
pixel is evaluated). The gray levels are then mapped to either 'black' or white' by 
the threshold value. Gray levels below the threshold are changed to white' while 
those at or above the threshold are changed to 'black. 5 



Arguments 

Argument Type Description 

level number Default: 128 

(0<n<255) 




Original 
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tile 



Description 

Fill the current image by tiling the specified image. 
Arguments 
Argument Type Description 

image string The name of the image in the image pool to be used as the 

tile. 



Example 

The first example takes the cat image, scales it to fit within a 64 pixel square, and 
uses this small picture as a tile on a blank image background. 

source=url [http : / /www. liquidpixels . ne t/ images /truff . jpg] , 

name [cat ]& 
scale=size[64]& 
blank=width[300 3 , height [300] & 
tile=image [cat] & 
sink 
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Here, we use LiquiFire to create the now ubiquitous Apple Effect' where an image 
is modified to contain lighter lines throughout: 

source=url [http: / /www. liquidpixels .net /images /truff . jpg] , 

name [cat] & 
scale=size[50%]& 

blank=width[4] , height [4] , name [tile] & 
draw=primitive [line] , points [0 0 3 0] , stroke [black] & 
draw=primitive[line] , points [0 2 3 2] , stroke [black] & 
blank=width[ (cat. width) ] , height [ (cat . height) ] ,name [lines] & 
ti le= image [tile] & 
brightness=value [30] & 
select=name [cat] & 

compos ite=compose [difference] , image [lines ]& 
sink 
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transparent 

Description 

Indicate that the color specified should be transparent in formats which support 
transparency. 

Arguments 

Argument Type Description 

color color Required. — 

The color to be marked transparent. 

Example 

text=f ont [GillSans-Bold] , pointsize [24] , fill [Navy] , 

text [Hello+Again] & 
transparent=color [white] & 
sink= format [gif 3 

Hello Again 
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usharpmask 



Description 

Applies an unsharp masking transformation to an image. 

Unsharp masking works by accentuating the difference between details, actually 
brightening and darkening adjacent pixels to increase apparent sharpness. 



Arguments 
Argument Type 



Description 



radius 



amount 



number 



number 



threshold number 



number 



Required. ~ 
The range of pixels adjacent to be affected. 
Required. 

The amount of adjustment to apply, as a percentage. 
Typical values range between 50 and 150 (%). 

Optional. 

If present, the threshold which must be exceeded before 
sharpening is applied; if omitted, all pixels are affected. 

Default: 5 

The standard deviation of the gaussian kernel, in pixels. 



Example 



Original 
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usharpmask=radius [ 1 3 , 
amount [150] 




usharpmask=radius [3 ] , 
amount [120] 




usharpmask^radius [1.5] , 
amount [120] 




usharpmask^radius [1] , 
amount [120] , sigma[10] 
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unoptimize 

Description 

Removes format-specific optimizations from an image. 

Certain formats, such as GIF-89, are capable of presenting their image data as sev- 
eral frames, each with its own origin, color table, and size. The unoptimize com- 
mand converts each frame into an image the full size of the background image, 
and creates a unified color table. Images that have been unoptimized are larger, 
but may be much more easily manipulated in a uniform fashion. 

Use the optimize command to reverse the process. 

Arguments 

none 
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watermark 



Description 

Hides an image in the low-order bits of the current image 
Arguments 
Argument Type Description 

image string Required. — — — — — . - 

The name of an image in the image pool to be hidden in 
the image 

offset number Optional. 

The numeric offset to be applied to the data as it is 
embedded. 



ISO 
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Macros addalpha 

Description 

Creates an image with transparency (alpha channel) from the combination of a 
color image and a mask image. The brightness of the mask image are used to 
define the opacity. 

Arguments 

Argument Type Description 

image url Required; 

f*1 The url for the color image 

«p mask url Required; 

■!*- The url for the mask image 

% S invert boolean Default: false 

j If true, the mask image is inverted before the 

fj combination process is performed 

name string Optional; 

y s If present, determines the the name for the combined 

!« s s image in the pool. 

JS Example 

if"? 

|4 addalpha=image [ht tp : / /www . 1 iquidpixel s . ne t / images /Gray . j pg ] , 

mask [http://www.liquidpixels.net/images/GrayMaskopg] , 

name [ shirt ] , invert [ true ] & 
blank=width [ shirt . width] , height [ shirt . height ] & 
composite=compose [over] , image [shirt] & 
sink 
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bullet 



Description 



Creates an image containing a dingbat, or symol, and a single line of text, similar 
to a bulleted item. 



I** 
si 
ft! 

H 



Arguments 
Argument 



Type 



Description 



integer Default: 10 

When the glyph argument is present, determines the size 
of the glyph drawn, in pixels, 

integer Optional; 

If present, determines the space, in pixels, surrounding the 
glyph drawn. If omitted, the space is set to one-half the 
size of the glyph. 

color Default: white 

If present, determines the the background color for the 
image. 

circle isquare Optional; 

If present, determines the shape of the glyph to image 
adjacent to the text. 

color Default: black 

If present, determines the color of the glyph 

color Optional; 

If present, the glyph is stroked (outlined) in the color 
specified. 

Default: 1 

If present, determines the thickness of the glyph stroke, 
name Optional; 

If present, the image named will be used in place of a 
graphic glyph. 

See "annotate" on page 85. 

See "annotate" on page 85. 



space 

bgcolor 

glyph 

glyphfill 
glyphstroke 

glyphswidth integer 
image name 



pomtsize 
font 
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Argument Type 



Description 



stroke 



swidth 



fill 



text 



See "annotate" on page 85. 
See "annotate" on page 85. 
See "annotate" on page 85. 
See "annotate" on page 85. 



Example 

bullet=text [Item+Number+Six] , points ize [16 ] , 

glyphf ill [darkred] , font [Arial -Roman] , fill [navy] , glyph [ square ] 
sink 

m Item Number Six 

source=url [ f i le : DingbatC . eps ] , name [pixels ] 
scale=size [20] 

bullet=text [LiquidPixels] ,pointsize [14 j , 

font [Arial -Roman] , image [pixels ] 
sink 

$ LiquidPixels 
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mftext 

Description 

Render text onto multiple frames of a multi-frame image. 

This macro adds a sequence of select - annotate pairs operators to the image 
chain. 



u 

mi 



m 

If- 



Arguments 

Argument Type 



start 



end 



xstep 



ystep 



gravity 
font 

pointsize 
fill 

stroke 
swidth 
text 



Description 



number Required. 

Frame number at which to start imaging text 
number Required. 

Frame number at which to end imaging text 
string Required. 

Name of multi-frame image in image pool on which text 
is to be rendered. 

number Required. 

Horizontal position of text baseline 
number Required. 

Vertical position of text baseline 

number Optional. 

If present, the horizontal position of the text baseline will 
be incremented by this value for each subsequent frame, 
resulting in animated text. 

number Optional. 

If present, the vertical position of the text baselinewill be 
incremented by this value for each subsequent frame 
resulting in animated text. 

See "annotate" on page 85. 

See "annotate" on page 85. 

See "annotate" on page 85. 

See "annotate" on page 85. 

See "annotate" on page 85. 

See "annotate" on page 85. 

string Required. 

The text to be rendered onto the selected frames 
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Example 

The banner image contains 39 frames of animation, and is stored as an optimized 
gif. Here, we use mftext three times to image a number onto multiple frames, so it 
persists for a portion of the animation. The optimize command removes this 
redundancy when the image is transmitted as GIF. 

source=url [http: //www. someserver.com/images/banner.gif] & 
unoptimize& 

mftext=start[l] , end[10] , name [_] , font [Gill Sans -Roman 3 , 

gravity [Southwest] ,x[50] ,y[-10] , text [ AAPL : +2 1 . 12 5 ] , 

pointsize [12] , fill [white] & 
mftext=start [11] ,end[20] ,name[J , f ont [GillSans-Roman] , 

gravity [Southwest] ,x[170] ,y[-10] , text [IBM: +114 . 05] , 

pointsize [ 12 ] , fill [white] & 
mftext=start[21] ,end[30] ,name [_] , font [Gil lSans- Roman] , 

gravity[Southwest] ,x[290] ,y[-10] , text [SUNW: +31 . 125 ] , 

pointsize [12 ] , fill [white] & 
select=name[_]& 
optimizes: 

sink= format [GIF] , loop [forever] 



sunw 3 t.m 



This example depicts the creation of a four-frame image with the word 'Wheee' 
imaged at four locations on each frame. 

blank=width[100] , height [50] .name [b]& 
blank=width[100] , height [50] ,name[a]& 
attribute=key [delay] , value [20 ]& 
addf rame=image [b] , delay [ 2 0 ] & 
addf rame=image [b] , delay [20 ]& 
addf rame=image [b] , delay [20 3 & 
select=image [a] & 

mftext=font[Arial-Roman] , pointsize [18] , text [Wheee] , 

start [1] , end [4] ,xstep[10] ,x[5] ,y [30] ,name[a] & 
select=image [a] & 
sink=f ormat [gif ] , loop [forever] 

Wheee Wheee Wheee Wheee 

Frame 1 Frame 2 Frame 3 Frame 4 
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text 



Description 

Image text onto a new, appropriately sized, background image. 

Text may contain Unicode characters, expressed as Unnnn, where nnnn is a valid 
Unicode character value, or as extended characters, expressed as \nnn, where nnn 
is a valid ascii-extended character code. 

Multiple lines may be imaged together; line breaks may be expressed by \n within 
the text. 

Additional typefaces can be added to LiquiFire via FTP or LiquiFire Orb, or via 

URL. 



Arguments 

Argument Type 



Description 



font 

pointsize 



string Required. 

The text to be rendered 

See "annotate' on page 85. 

See "annotate" on page 85. 

string Optional. 

If specified, the new image created by the text macro will 
be added to the image pool under this name. Otherwise, 
the image will be created as the current image. 

number Optional. 

If specified, the background image will be larger than the 
bounding-box of the text by the specified number of 
pixels. 

number Optional. 

If specified, the background image will be larger in width 
than the bounding-box of the text by the specified 
number of pixels. Overrides pad. 

number Optional. 

If specified, the background image will be larger in height 
than the bounding-box of the text by the specified 
number of pixels. Overrides pad. 

string Default: white 

The color of the background image 

See "annotate" on page 85. 



pad 



padx 



pady 



bgcolor 



fill 
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Example 

Notice the two escaped characters using two separate escaping methods: the 
\054, representing the \ ' using the * \ ' to specify an extended character, and 
the * + ' representing a space * * using http url-encoding. 

text=text [LiquidPixels\054+Incorporated] , 

font [Anyway- Bold] , pointsize [24] & 
sink 
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textcurve 

Description 

Render text along the radius of a curve. 



as* 



Arguments 
Argument Type 



Description 



text 

font 
fill 

pointsize 
stroke 
swidth 
radius 



start 



spacing 



string Required. 

The text to be rendered onto the current image 

See "annotate" on page 85. 

See "annotate" on page 85. 

See "annotate" on page 85. 

See "annotate" on page 85. 

See "annotate" on page 85. 

number Required. 

The radius, in pixels, of the circle on which the text will 
be imaged 

number Required. 

The horizontal location of the center of the curcle 
number Required. 

The vertical location of the center of the curcle 
number Optional. 

If present, the text will start from the angle specified and 
continue clockwise. If omitted, the text is centered along 
the top edge of the circle 

number Optional. 

If present, letters will be drawn at the specified separation. 
If omitted, letters are drawn following the font-specified 
character spacing 
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Example 

blank=width[200] , height [200] , color [gray8 0 3 & 
textcurve=text [Hello+LiquiFire] ,x[100] ,y[100] , radius [80] , 

f ont [Arial -Roman] ,pointsize [20] , fill [green] & 
sink 
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dump 

Description 

Causes LiquiFire to dump the entire metadata table for the current image into the 
activity log. Useful at times for debugging complex metadata manipulations. 

To access the activity log, the Job ID is required. The showid command can be 
used to facilitate access to this execution information via LiquiFire Orb. See "sho- 
wid" on page 14 1. 

Arguments 

none 



'"'"4 

m 



160 



LiquiFire User's Guide: Base Command Set 



Metacommands auth 

Description 

Convey authorization information for a request. 

Arguments 
Argument Type Description 

hash string Optional; hash or c ipher must be present. 

If present, indicates the provided key is a unique hash 
specific to the request and unique server secret.' 

cipher string Optional; hash or cipher must be present. 

If present, indicates the provided key is a unique 
cryptographic cipher specific to the request and unique 
server secret.' 

Example 

source=url [http : / /www. liquidpixels . net /images /cat . jpg] & 
scale=geometry [200x200 ]& 
auth=hash [d409f b3 0 ] & 
sink 
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countdown 



ry 



Description 

Calculates the time remaining from the current time until the date specified. 



Arguments 
Argument Type 



Description 



key string Required. 

The name of the metadata field to set 

target string Required. 

The rarget date, in practically any format, including: 
Dow, dd Mon yyyy, dd Mon yy, dd Mon yyyy, Mon dd 
yyyy, yyyy/mm/dd, yyyy/mm, mm/dd/yy, mm/dd/yyyy, 
mm/yy } count "days", count "weeks", count "months", 
count "years ', Dow "after next", "next" Dow, "tomorrow", 
"today", "yesterday", "last" dow, "last week" 

name string Optional. 

If specified, the name of the image where the resulting 
metadata will be set. If omitted, the Global metadata will 
be set. 

type Days (Seconds Default: days 

Seconds: returns the countdown in seconds remaining 
until the target date. 

Days: returns the countdown in days remaining to the 
target date. 



Example 

countdown=key [day] , target [11/22 /2 001] & 

text=text [There+are+ (global . day) +days+till+Thanksgiving] , 

f ont [Arial-Roman] ,pointsize [16] & 
sink 
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There are 294 days till Thanksgiving 



Q 

a 

H 

ru 

H 

u 

w 
u 

A 
Q 
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fontmetrics 

Description 

Determines the future resulting size of text when rendered in a specified font and 
size. 

The resulting dimensions are added as esoteric metadata to the current image 
under the names metrics. x and metrics. y. 

Arguments 
Argument Type Description 

text string Required. ___ _ _ 

The text to be measured 
font string Required. 

The name of the typeface in which to render the text 
pointsize number Required. 

The size, in points, in which to render the text 

Example 

fontmetrics=text [Hello] , pointsize [30] , f ont [Arial-Bold] & 
blank=width[ {_. me tries .x%2B5 ) ] , height [ (_. metrics .y%2B5) ]& 
annotate=text [Hello] , pointsize [30] , gravity [Center] , 

font [Arial-Bold] & 
sink 



Hello 
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load 

Description 

Retrieve an image chain, or image chain fragment stored in a file from a web 
server, ftp server, or file within a LiquiFire server. 

Arguments 

Argument Type Description 

url url Required. — — — 

Describes the source for the image data 

Example 

With a file named /chains / tab . chain containing 
source=url [ f ile : tab. eps] & 

annotate==font[Arial-Roman] ,pointsize [9] , text [global . section] , 
gravity [Center] , fill [black] 

located on a server ht tp : / / www . liquidpixels . net, the request: 
set=key [section] , value [Section+One] & 

load=url [http : / /www. liquidpixels . net/chains/ tab . chain] & 
sink=format [gif ] 

creates the effective request 

set=key [section] , value [Sect ion+One] & 
source=url [ file : tab . eps] & 

annotate^ font [Arial -Roman] , pointsize [ 9 ] , text [global . section] , 

gravity [Center] , fill [black] & 
sink= format [gif 3 
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regexcase 

Description 

A case statement for string expression matching. 

Given a list of strings, returns the corresponding value when the key matches < 
of the specified expressions. 

Arguments 

Argument Type Description 



key string 
name string 

cases string 



values 



default 



string 



string 



Required. 

The key to match against the cases. 
Required. 

The name of the global metadata field to contain the 
result 

Required. 

AT separated list of extended regular expression patterns. 
Cases are searched in order. 

Required 

AT separated list of results to return when the specified 
key matches the corresponding expression specified in 
cases 

Optional. 

The result to return should the key does not match any of 
the specified expressions 



Example 

In this example, the countdown command is used to calculate the number of 
days remaining until November 22, 2001. This value, stored in the global meta- 
data field day is then matched against two regular expressions with the regex- 
case command. The first expression, '~ . $', will match a single character, while 
the second expression, ' . will match one or more characters. If the number of 
days is 9 or less - a single digit - the first expression will match and regexcase 
will set the global metadata field vday to a few'. Otherwise, global . vday is 
set to the value in the global . day field originally set by countdown. 
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countdown=key[day] , target [11/22/2001J& 
regexcase=name [vday ] , key [global . day] , cases [ A . $ | . %2b] , 

values [a+f ew | global . day] & 
text=text [There+are+global . vday+days+till+Thanksgiving] , 

font [Arial -Roman] , pointsize [16] & 
sink= format [gif ] 



There are a few days till Thanksgiving 
There are 294 days till Thanksgiving 
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set 

Description 

Sets a field in the global metadata to the value specified 
Arguments 

Argument Type Description 

key string ~ Required. 

The name of the field to set 

value string Optional. 

If specified, the value of the field will be set to the value 
specified. If omitted, the value of the metadata field will 
be cleared. 
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time 



Description 

Populate esoteric metadata fields with values corresponding to the date and time 
specified, or the current time, if no date is specified. 

The time command populates 33 subfields of the global . date metadata field. 



Arguments 

Argument Type 



Description 



date string Optional. If omitted, the current time and date 

The time and/or date for which the fields should be 
populated. Times can be expressed in practically any 
format, including: 

Dow dd Mon yyyy, dd Mon yy, dd Mon yyyy Mon dd 
yyyy, yyyy/mm/dd, yyyy/mm, mm/dd/yy, mm/dd/yyyy, 
mm/yy, count "days", count "weeks", count "months", 
count "years", Dow "after next", "next" Dow, "tomorrow", 
"today", "yesterday", "last" dow, "last week" 



Fields 



Format 


Description 


Example 


date.zhour 


Hour number, 24 hour format, with leading zero 


00 


date.zhr 


Hour number, 12 hour format, with leading zero 


00 


date.hour 


Hour number, 24 hour format 


0 


date.hr 


Hour number, 12 hour format 


0 


date.zmin 


Minute number, with leading zeros 


45 


date.min 


Minute number 


45 


date.zsec 


Second number, with leading zeros 


56 


date, sec 


Second number 


56 


date.zday 


Day number, with leading zero 


01 


date.day 


Day number 


1 


date.zmnum 


Month number, with leading zeros 


01 


date.mnum 


Month number 


1 


date.mon 


Abbreviated month name 


Jan 


date.month 


Month name 


January 
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Format 


Description 


Example 


date.yr 


Year, 2 digit format 


03 


date.year 


Year, 4 digit format 


2003 


date.zdoy 


Day of the year, starting from 1, with leading 
zeros 


001 


date,doy 


Day of the year, starting from 1 


1 


date.wkdy 


Abbreviated day of the week 


Mon 


date.weekday 


Day of the week 


Monday 


date.wkdynum 


Week number, weeks start on Sunday 


4 


date.monornate 


Ornate month (st, nd, rd) 


2nd 


date.ampm 


Meridian indication 


AM 


date.quarter 


Year quarter number 


1 


date.zone 


Timezone, abbreviated universal form 


EST 


date.zonenum 


Timezone, numeric form 


-0500 


date.mdyhms 


Terse month/day/year hour:minute:second 


01/01/01 
00:00:00 


dace.long 


Standard Internet format, including timezone 


Mon Jan 1 
00:00:00 EST 
2001 


date.mdy 


Terse month/day/year 


01/01/01 


date.hms 


hour: minute: second 


03:45:56 


date.hm 


hounminute 


03:45 


date.hmsampm 


hour:mmute:second with meridian 


03:45:56 AM 


date.common 


Common long form date 


Thursday, 
January 2, 2003 


date.commontz 


Common long form date, with timezone 


Thursday, 
January 2, 2003 
EST 



Example 

time=date[l/2/2003+3:05;56]& 

text= font [Arial -Roman] , pointsize [14] , text [global .elate. common] & 
sink 

Thursday, January 2, 2003 
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timecase 

Description 

A case statement for dates. 

Given a list of dates, times, or date-times, returns the corresponding value when 
the current time falls within one of the specified ranges. 

Arguments 

Argument Type Description 

Required. 

The name of the global metadata field to contain the 
result 

Required. 

A * | ' separated list of rime ranges. Ranges are specified as 
two times, separated by a dash ('-'). Times can be 
expressed in practically any format, including: 

Dow, dd Mon yyyy, dd Mon yy, dd Mon yyyy, Mon dd 
yyyy, yyyy/mm/dd, yyyy/ mm, mm/dd/yy, mm/dd/yyyy, 
mm/yy, count "days", count "weeks", count "months", 
count "years ', Dow "after next", "next" Dow, "tomorrow", 
"today", "yesterday", "last" dow, "last week" 

Required. 

A T separated list of results to return when the current 
date falls within the corresponding date range specified in 
cases 

Optional. 

The result to return when the current date does not fall 
within any of the specified ranges 

Example 

Assuming a clothing sale runs for the seven days prior to Halloween, the following 
chain would display a sale indicator atop the image only during the sale period: 



name string 

a ■ 

b 

cases string 



if ^ 



values string 



default string 
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timecase=name[ss] , cases [10/24/2001-10/31/2 001] , 

values [1] , default [0 3 & 
source=url [f ile:o/SpikeySplat .svg] , name [splat] & 
transparent=color [white 3 & 

annotate=text[Salei ] , font [GillSans-Boldltalic] , 
pointsize[fit] , width [ (splat .width- 60) ] , 
height [ (splat .height- 60) ] , 

gravity [Center] , fill [red] , stroke [black] , swidth [2] , 

if [global. ss]& 
source=url [http : / /www. liquidpixels . net/images/shirttie/ 

Blue-s. jpg] , name [shirt] & 
scale-size [200] & 

blank=width [ 3 0 0 3 , height [ shirt . height ] & 
compos ite= image [shirt] & 

composite=image [splat] , gravity [northeast 3 , if [global . ss3 & 
sink=f ormat [ jpg] 




current date is between current date outside the range 

10/24/2001 and 10/31/2001 



APPENDIX A 



Color Definitions 



When color is to be specified, it may be described by name or by component value. 
To describe by value, colors are specified in the following format: 



&RRGGB3 



where RR represents a hexadecimal value for the Red component, GG represents a 
%$ hexadecimal value for the Green component, and BB represents a hexadecimal value 

f || fo r the Blue component. Note that within requests presented over HTTP, the V 

i symbol must be escaped as 1 % 2 3 . ' 



The list of supported color names, along with their definitions are identified in the 
tables that follow. 
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0/ 0/ 0 
0/ 0/ 0 
black 




5/ 5/ 5 
0/ 0/ 5 
grey2 




13/13/13 
0/ 0/13 
grey5 




20/20/20 
0/ 0/ 20 



28/ 28/ 28 
0/ 0/28 
greyl 1 




36/36/36 
0/ 0/ 36 
greyl 4 




43/ 43/43 
0/ 0/43 
greyl 7 




51/51/51 
0/ 0/ 51 
grey20 




59/59/59 
0/ 0/ 59 
grey23 




0/ 0/ 0 
0/ 0/ 0 
grayO 




8/ 8/ 8 
0/ 0/ 8 
gray3 




15/15/15 
0/ 0/15 
gray6 




23/23/23 
0/ 0/23 
gray9 




31/31/31 
0/ 0/ 31 
gray12 




38/ 38/ 38 
0/ 0/38 
grayl 5 




46/ 46/ 46 
0/ 0/46 
grayl 8 




54/54/54 
0/ 0/54 
gray21 




61/61/61 
0/ 0/61 
gray24 




0/ 0/ 0 
0/ 0/ 0 
greyO 




8/ 8/ 8 
0/ 0/ 8 
grey3 




15/15/15 
0/ 0/15 
grey6 



23/23/23 
0/ 0/23 
grey9 




31/31/31 
0/ 0/ 31 
greyl 2 




38/38/38 
0/ 0/38 
greyl 5 




46/ 46/ 46 
0/ 0/46 
greyl 8 




54/54/54 
0/ 0/54 
grey21 




61/61/61 
0/ 0/61 
grey 24 




3/ 3/ 3 
0/ 0/ 3 
grayl 




10/10/10 
0/ 0/10 
gray4 




18/18/18 
0/ 0/18 
gray7 




28/26/26 
0/ 0/ 26 
grayl 0 




33/ 33/ 33 
0/ 0/33 
grayl 3 




41/41/41 
0/ 0/41 
grayl 6 




48/ 48/ 48 
0/ 0/48 
grayl 9 




56/56/56 
0/ 0/ 56 
gray22 




64/64/64 
0/ 0/64 
gray25 




3/ 3/ 3 
0/ 0/ 3 
greyl 




10/10/10 
0/ 0/10 
grey4 




18/18/18 
0/ 0/18 
grey7 




26/ 26/26 
0/ 0/26 
greyl 0 



33/33/33 
0/ 0/ 33 
greyl 3 



41/41/41 
0/ 0/41 
greyl 6 




48/ 48/ 48 
0/ 0/48 
greyl 9 




56/56/56 
0/ 0/56 
grey22 




64/ 64/64 
0/ 0/64 
grey25 




5/ 5/ 5 
0/ 0/ 5 
gray2 




13/13/13 
0/ 0/13 
gray5 




20/20/20 
0/ 0/ 20 
gray8 




28/28/28 
0/ 0/28 
grayl 1 




36/ 36/ 36 
0/ 0/36 
grayl 4 




43/43/43 
0/ 0/43 
grayl 7 




51/51/51 
0/ 0/51 
gray20 




59/59/59 
0/ 0/ 59 
gray23 




66/ 66/66 
0/ 0/66 
gray28 
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86/66/66 69/69/69 
0/ 0/66 0/ 0/69 
gray27 




74/74/74 
0/ 0/74 
grey29 



82/82/ 82 
0/ 0/82 
grey32 



77/77/77 
0/ 0/77 
graySO 



84/ 84/ 84 
0/ 0/84 
gray33 




99/99/99 
0/ 0/99 



grey38 


gray39 




■m 


105/105/105 
0/ 0/105 
Dim Gray 


105/105/105 
0/ 0/105 
dim grey 


MB 




107/107/107 
0/ 0/107 
grey42 


110/110/110 
0/ 0/110 
gray43 


iiiiii i 




115/115/115 
0/ 0/115 
grey45 


117/117/117 
0/ 0/117 
gray46 




liiitiiiii 


122/122/122 125/125/125 
0/ 0/122 0/ 0/125 
grey48 gray49 





I 


mm & 

%K 


69/69/69 


71/71/71 


0/ 0/69 


0/ 0/71 


grey27 


gray28 








77/77/77 


79/79/79 


0/ 0/77 


0/ 0/79 


grey30 


gray31 


m 


i 




84/84/84 


87/87/87 


0/ 0/84 


0/ 0/87 


grey33 


gray34 








92/92/92 


94/94/94 



71/71/ 71 
0/ 0/71 
grey28 



74/74/74 
0/ 0/74 
gray29 



79/ 79/ 79 82/ 82/ 82 
0/ 0/79 0/ 0/82 
grey31 gray32 



87/87/87 
0/ 0/87 
grey34 



89/ 89/ 89 
0/ 0/89 
gray35 



0/ 0/92 
grey36 



99/ 99/ 99 
0/ 0/99 
grey39 



0/ 0/94 
gray37 



94/94/94 
0/ 0/94 
grey37 



97/ 97/ 97 
0/ 0/97 
gray38 



llillll 

102/102/102 102/102/102 105/105/105 

0/ 0/102 0/ 0/102 0/ 0/105 

gray40 grey40 dim gray 



105/105/105 
0/ 0/105 
Dim Grey 



110/110/110 
0/ 0/110 
grey43 



105/105/105 
0/ 0/105 
gray41 



112/112/112 
0/ 0/112 
gray44 



105/105/105 107/107/107 
0/ 0/105 0/ 0/107 
grey41 gray42 



117/117/117 
0/ 0/117 




125/125/125 
0/ 0/125 
grey49 



120/120/120 
0/ 0/120 
gray47 

m 



mil 

127/127/127 
0/ 0/127 
graySO 



lllillill 



112/112/112 
0/ 0/112 
grey44 



120/120/120 
0/ 0/120 
grey47 



127/127/127 
0/ 0/127 
greySO 



115/115/115 
0/ 0/115 
gray45 



122/122/122 
0/ 0/122 
gray48 



130/130/130 
0/ 0/130 
gray51 
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130/130/130 133/133/133 133/133/133 135/135/135 
0/ 0/130 0/ 0/133 0/ 0/133 0/ 0/135 
grey51 gray52 grey52 gray53 



135/135/135 138/138/138 
0/ 0/135 0/ 0/138 
grey53 gray54 

■ 1 



138/138/138 140/140/140 
0/ 0/138 0/ 0/140 
grey54 gray55 



145/145/145 
0/ 0/145 
grey57 



148/148/148 
0/ 0/148 
gray58 



153/153/153 
0/ 0/153 



156/158/156 
0/ 0/156 
gray61 




161/161/161 163/163/163 
0/ 0/161 0/ 0/163 
grey63 gray64 



168/168/168 169/169/169 
0/ 0/168 0/ 0/169 
dark grey 




140/140/140 
0/ 0/140 
grey55 



143/143/143 
0/ 0/143 
gray 56 



143/143/143 145/145/145 
0/ 0/143 0/ 0/145 
grey56 gray57 




148/148/148 
0/ 0/148 
grey58 



m 

156/156/156 
0/ 0/156 
grey61 



150/150/150 
0/ 0/150 
gray59 



158/158/158 
0/ 0/158 
gray62 



150/150/150 153/153/153 
0/ 0/150 0/ 0/153 
grey59 gray60 



158/158/158 
0/ 0/153 
grey62 



161/161/161 
0/ 0/161 
gray63 




169/169/169 169/169/169 169/169/169 171/171/171 

0/ 0/169 0/ 0/169 0/ 0/169 0/ 0/171 

DarkGrey dark gray DarkGray gray67 

^-^■■■■^ saps 



mam wmawsm mmm WSffK 

171/171/171 173/173/173 173/173/173 176/176/176 176/176/176 179/179/179 
0/ 0/171 0/ 0/173 0/ 0/173 0/ 0/176 0/ 0/176 0/ 0/179 



grey67 



gray68 



grey68 



gray69 



grey69 



gray70 



179/179/179 181/181/181 181/181/181 184/184/184 184/184/184 186/186/186 



0/ 0/179 
grey70 



0/ 0/181 
gray71 



0/ 0/181 
grey71 



0/ 0/184 
gray72 



0/ 0/184 
grey72 



0/ 0/186 
gray73 



186/186/186 189/189/189 189/189/189 190/190/190 
0/ 0/186 0/ 0/189 0/ 0/189 0/ 0/190 
grey73 gray74 grey74 gray 



190/190/190 191/191/191 
0/ 0/190 0/ 0/191 
grey gray75 
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191/191/191 
0/ 0/191 
grey75 



199/199/199 
0/ 0/199 
grey78 



207/207/207 
0/ 0/207 
grey81 

m S0 

**** Lrf*^ 

211/211/211 
0/ 0/211 
LightGray 

217/217/217 
0/ 0/217 
grey85 



224/224/224 
0/ 0/224 
gray88 

232/232/232 
0/ 0/232 

gray91 



IMS I 

194/194/194 
0/ 0/194 
gray76 




201/201/201 

0/ 0/201 
gray79 



209/209/209 
0/ 0/209 
gray 82 



212/212/212 

0/ 0/212 
gray83 

SIS 

219/219/219 
0/ 0/219 



224/224/224 

0/ 0/224 
grey88 

232/232/232 
0/ 0/232 

grey91 



201/201/201 

0/ 0/201 
grey79 



209/209/209 
0/ 0/209 
grey 8 2 

1318 

212/212/212 

0/ 0/212 
grey83 

219/219/219 
0/ 0/219 



. ...:.\: :; ;: : ;;'. : 

227/227/227 
0/ 0/227 



235/235/235 
0/ 0/235 
gray92 



196/196/196 
0/ 0/196 
gray77 

^ ; ^^^£^^ 

204/204/204 

0/ 0/204 
gray80 



211/211/211 
0/ 0/211 
light grey 

^5 

214/214/214 

0/ 0/214 
gray84 

SI 

220/220/220 
0/ 0/220 
gainsboro 



199/199/199 
0/ 0/199 
gray78 

207/207/207 

0/ 0/207 
gray81 



196/196/196 
0/ 0/196 
grey77 



204/204/204 

0/ 0/204 
grey80 



211/211/211 
0/ 0/21 1 
LightGrey 

214/214/214 
0/ 0/214 



>2 

222/222/222 
0/ 0/222 
gray87 



211/211/211 
0/ 0/211 
light gray 

217/217/217 

0/ 0/217 
gray85 

222/222/222 
0/ 0/222 
grey87 



227/227/227 229/229/229 229/229/229 

0/ 0/227 0/ 0/229 0/ 0/229 
grey89 gray90 grey90 



235/235/235 
0/ 0/235 



237/237/237 

0/ 0/237 
gray93 



237/237/237 

0/ 0/237 
grey93 



240/240/240 240/240/240 242/242/242 242/242/242 

0/ 0/240 0/ 0/240 0/ 0/242 0/ 0/242 
gray94 grey94 gray95 grey95 



245/245/245 245/245/245 
0/ 0/245 0/ 0/245 
white smoke WhiteSmoke 



245/245/245 245/245/245 
0/ 0/245 0/ 0/245 
gray96 grey96 



247/247/247 247/247/247 
0/ 0/247 0/ 0/247 
gray97 grey97 



250/250/250 250/250/250 
0/ 0/250 0/ 0/250 
gray98 grey98 
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252/252/252 252/252/252 255/255/255 255/255/255 255/255/255 139/137/137 



0/ 0/252 




0/ 0/252 
grey99 



0/ 0/255 
white 



0/ 0/255 
graylOO 



0/ 0/255 
greylOO 



0/ 3/137 
snow4 



205/201/201 255/250/250 255/250/250 238/233/233 188/143/143 188/143/143 
0/ 4/201 0/ 5/250 0/ 5/250 0/ 5/233 0/61/143 0/61/143 
snow3 snow snowl snow2 rosy brown RosyBrown 



255/193/193 238/180/180 205/155/155 139/105/105 240/128/128 
0/62/193 0/62/180 0/62/155 0/62/105 0/119/128 
RosyBrownl RosyBrown2 RosyBrown3 RosyBrown4 light coral 



240/128/128 
0/119/128 
LightCoral 

11 



205/92/92 
0/140/92 
indian red 


205/92/92 
0/140/92 
IndianRed 




165/42/42 
0/190/42 
brown 


139/35/35 
0/190/35 
brown4 




255/48/48 
0/207/48 
firebrickl 


139/26/26 
0/207/26 
firebrick4 




238/ 0/ 0 
0/255/ 0 
red2 


205/ 0/ 0 
0/255/ 0 
red3 



139/58/58 238/99/99 255/106/106 205/85/85 
0/148/58 0/148/99 0/149/106 0/149/85 
lndianRed4 lndianRed2 IndianRedl lndianRed3 



0/191/64 
brown 1 



205/38/38 
0/207/38 
firebrick3 



139/ 0/ 0 
0/255/ 0 
red4 



0/191/51 
brown3 



238/44/44 
0/207/44 
firebrick2 



139/ 0/ 0 
0/255/ 0 
dark red 



0/191/59 
brown2 



139/ 0/ 0 
0/255/ 0 
DarkRed 



0/206/ 34 
firebrick 



255/ 0/ 0 255/ 0/ 0 
0/255/ 0 0/255/ 0 
red redl 



205/183/181 
5/29/181 
MistyRose3 



255/228/225 255/228/225 255/228/225 250/128/114 238/213/210 139/125/123 

6/30/225 6/30/225 6/30/225 6/138/114 6/30/210 8/29/123 
misty rose MistyRose MistyRosel salmon MistyRose2 MistyRose4 



205/79/57 238/92/66 255/99/71 255/99/71 139/54/38 205/91/69 
9/184/57 9/184/66 9/184/71 9/184/71 10/185/38 10/169/69 
tomato3 tomato2 tomato tomatol tomato4 cora!3 
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mm 

lililiilil 






139/62/47 


238/106/80 


10/168/47 


10/169/80 


corai4 




coral2 



||||||:|::|:l||f'i: 
l^lllllllllll 

255/114/86 
10/169/86 
coral 1 

•Y " 



salmon 1 







% 1 1 


m 


238/130/98 
14/150/98 
salmon2 


205/112/84 
14/150/84 
salmon3 


139/76/57 
14/150/57 
salmon4 


■St 






Blllllli 


1 39/ 37/ 0 205/ 55/ 0 255/1 27/ 80 
16/255/ 0 16/255/ 0 16/175/80 
OrangeRed4 OrangeRed3 coral 



238/64/ 0 255/69/ 0 255/69/ 0 255/69/ 0 238/149/114 255/160/122 
1 6/255/ 0 1 6/255/ 0 1 6/255/ 0 1 6/255/ 0 1 7/1 32/1 14 17/1 33/1 22 
OrangeRed2 orange red OrangeRed OrangeRedl LighiSalmon2 light salmon 



255/160/122 255/160/122 139/87/66 205/129/98 205/104/57 238/121/66 
17/133/122 17/133/122 17/133/66 17/133/98 19/184/57 19/184/66 
LightSalmon LightSalmonl LightSalmon4 LightSafmon3 sienna3 sienna2 



255/130/71 160/82/45 139/71/38 255/245/238 255/245/238 238/118/33 
19/184/71 19/183/45 20/185/38 25/17/238 25/17/238 25/219/33 
siennal sienna sienna4 seashell seashelh chocolate2 



205/102/29 255/127/36 210/105/30 139/69/19 139/69/19 139/69/19 
25/218/29 25/219/36 25/218/30 25/220/19 25/220/19 25/220/19 
chocolate3 chocolatel chocolate saddle brown SaddleBrown chocolate4 



205/197/191 
26/17/191 
seashell3 



205/175/149 

28/69/149 

PeachPuff3 



238/229/222 
26/17/222 
seashell2 

255/218/185 
28/70/185 
peach puff 



139/134/130 244/164/96 

27/16/130 28/154/96 

seashe!!4 sandy brown 

255/218/185 255/218/185 

28/70/185 28/70/185 

PeachPuff PeachPuffl 



244/1 64/ 96 238/203/1 73 
28/154/96 28/69/173 
SandyBrown PeachPuff2 



139/119/101 255/165/79 
28/69/101 29/176/79 
PeachPuff4 tan1 



139/90/43 238/154/73 205/133/63 205/133/63 238/118/ 0 139/69/0 
29/176/43 29/176/73 30/176/63 30/176/63 30/255/ 0 30/255/0 
ten4 tan2 P e ™ tan3 DarkOrange2 DarkOrange4 
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205/102/ 0 255/127/ 0 
30/255/ 0 30/255/ 0 
DarkOrange3 DarkOrangel 



238/213/183 255/140/ 0 
33/58/183 33/255/ 0 
bisque2 dark orange 

238/223/204 238/1 97/1 45 
34/36/204 34/99/145 
Antique White 2burlywood2 



250/240/230 
30/20/230 
linen 

255/140/ 0 
33/255/ 0 
DarkOrange 

255/211/155 
34/100/155 
burlywoodl 



205/183/158 255/228/196 255/228/196 
32/58/158 33/59/196 33/59/196 
bisque3 bisque bisquel 



205/192/176 255/239/219 139/115/85 
33/ 36/176 33/ 36/21 9 33/ 99/ 85 
AntiqueWhite3AntiqueWhite1bur!ywood4 



250/235/215 
34/35/215 
antique white 

255/222/173 

36/82/173 

NavajoWhite 



139/125/107 205/170/125 222/184/135 
34/58/107 34/99/125 34/99/135 
bisque4 burlywood3 burlywood 

250/235/215 210/180/140 139/131/120 238/207/161 255/222/173 
34/35/215 34/85/140 35/34/120 36/82/161 36/82/173 
/^ueWhite tan AntiqueWhite4NavajoWhite2 navajo white 

255/222/173 255/235/205 255/235/205 139/121/94 205/179/139 
36/82/173 36/50/205 36/50/205 36/82/94 36/82/139 
NavajoWhitel blanched almoBtenchedAlmohl(ivajoWhite4Nava]oWhite3 

J-'- %t"t S.J%^-:-:: : :W^i«x-:x- - <™.-.v. 



255/239/213 
37/42/213 
papaya whip 



255/239/213 255/228/181 
37/42/213 38/74/181 
PapayaWhip moccasin 



255/165/ 0 
39/255/ 0 
orange 



255/165/ 0 
39/255/ 0 
orange 1 



238/154/ 0 
39/255/ 0 
orange2 



139/90/ 0 
39/255/ 0 
orange4 

255/231/186 
39/69/186 
wheatl 



139/126/102 
39/67/102 
wheat4 



205/133/ 0 
39/255/ 0 
orange3 




245/222/179 253/245/230 253/245/230 
39/ 68/1 79 39/ 23/230 39/ 23/230 
wheat old lace OldLace 



255/250/240 255/250/240 255/185/15 
40/ 1 5/240 40/ 1 5/240 43/240/ 1 5 
floral white FloralWhite DarkGoldenrod! 



238/173/14 205/149/12 139/101/ 8 184/134/11 184/134/11 139/105/20 
43/240/14 43/240/12 43/240/ 8 43/239/11 43/239/11 43/218/20 
DarkGoldenrod&rkGoldenro<S2arkGoidenrodiferk goldenro<DarkGoldenrodjo!denrod4 
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. . ami-' . 

- , TM*\ , ' U 
238/232/205 
49/ 35/205 
cornsilk2 



205/200/177 

49/34/177 

comsilk3 

II 





139/117/ 0 


139/136/120 




51/255/ 0 


51/34/120 




gold4 


cornsilk4 


i! : 
ipsa 








ISIIilll 


Wmik 




205/173/ 0 


238/201/ 0 




51/255/ 0 


51/255/ 0 




gold3 


gold2 






fc:»,J 


if: ji 








255/250/205 


240/230/140 




54/ 50/205 


54/106/140 



LemonChifforrkhaki 

205/198/115 238/230/133 
55/111/115 55/112/133 
khaki3 khaki2 



238/180/34 205/155/29 255/248/220 255/248/220 

43/218/34 43/218/29 48/35/220 48/35/220 

goidenrod2 goldenrod3 cornsilk cornsilkl 

238/220/130 255/236/139 205/190/112 139/129776 

50/115/130 50/116/139 50/115/112 50/115/76 
LightGoldenro<U^htGoldenrodL1ghtGoldenrodl^htGoldenrod4 

SSySfc Wz&b 



238/221/130 238/221/130 255/215/ 0 255/215/ 0 
51/115/130 51/115/130 51/255/ 0 51/255/0 
light goldenrodLightGoldenro^old goldl 



238/233/191 205/201/165 255/250/205 255/250/205 
54/50/191 54/49/165 54/50/205 54/50/205 
LemonChiffon2_emonChiffon3emon chiffon LemonChiffon 



238/232/170 238/232/170 139/134/78 255/246/143 
55/72/170 55/72/170 55/111/78 55/112/143 
pale go!denrocPaleGoldenrockhaki4 khakil 



139/137/112 189/183/107 189/183/107 139/139/131 
56/49/112 56/110/107 56/110/107 60/14/131 
LemonChiffon4Jark khaki DarkKhaki ivory4 



205/205/193 238/238/224 
60/14/193 60/15/224 
ivory3 ivory2 



255/255/224 255/255/224 
60/31/224 60/31/224 
LightYellow LightYellowl 



255/255/240 

60/15/240 

ivory 

238/238/209 

60/31/209 

LightYellow2 



255/255/240 245/245/220 255/255/224 
60/ 1 5/240 60/ 26/220 60/ 31 /224 
ivoryl beige light yellow 



205/205/180 139/139/122 250/250/210 
60/31/180 60/31/122 60/40/210 
LightYeliow3 LightYellow4 light goldenrod yellow 



250/250/210 255/255/ 0 255/255/ 0 
60/40/210 60/255/ 0 60/255/ 0 
LightGoldenro#¥&Haw yellow! 



238/238/ 0 205/205/ 0 139/139/ 0 
60/255/ 0 60/255/ 0 60/255/ 0 
yellow2 yeilow3 yellow4 
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; I 

105/139/34 192/255/62 107/142/35 107/142/35 179/238/58 154/205/50 

80/192/35 80/192/35 80/192/58 80/192/50 

olive drab OliveDrab OliveDrab2 yellow green 



79/192/34 80/193/62 
OliveDrab4 OliveDrabl 



154/205/50 154/205/50 85/107/47 85/107/47 202/255/112 110/139/61 
80/192/50 80/192/50 82/142/47 82/142/47 82/143/112 82/143/61 
YellowGreen OliveDrab3 dark olive greeBarkOliveGreeBarkOliveGree2larkOliveGreen4 



mffl&M 



188/238/104 162/205/90 173/255/47 173/255/47 127/255/ 0 127/255/0 
82/143/104 82/143/90 84/208/47 84/208/47 90/255/ 0 90/255/0 
DarkOliveGreeaarkOliveGreegiSen yellow GreenYellow chartreuse chartreuse 1 



102/205/ 0 69/139/ 0 118/238/ 0 124/252/ 0 124/252/ 0 131/139/131 
90/255/ 0 90/255/ 0 90/255/ 0 90/255/ 0 90/255/ 0 120/ 14/131 
chartreuse3 chartreuse4 chartreuse2 lawn green LawnGreen honeydew4 



rii 



193/205/193 224/238/224 240/255/240 240/255/240 143/188/143 143/188/143 
120/14/193 120/15/224 120/15/240 120/15/240 120/61/143 120/61/143 
honeydew3 honeydew2 honeydew ho^neydewl dark sea greerDarkSeaGreen 

193/255/193 180/238/180 155/205/155 105/139/105 152/251/152 152/251/152 
120/62/193 120/62/180 120/62/155 120/62/105 120/100/152 120/100/152 
DarkSeaGreerDarkSeaGreerQarkSeaGreerOarkSeaGreerpfele green PaleGreen 



144/238/144 144/238/144 144/238/144 124/205/124 84/139/84 154/255/154 
120/100/144 120/100/144 120/100/144 120/100/124 120/100/84 120/101/154 
PaleGreen2 light green LightGreen PaleGreen3 PaIeGreen4 PaleGreenl 



34/139/34 34/139/34 50/205/50 50/205/50 0/100/ 0 0/100/0 
120/192/34 120/192/34 120/192/50 120/192/50 120/255/ 0 120/255/0 
forest green ForestGreen lime green LimeGreen dark green DarkGreen 



0/255/ 0 0/255/ 0 0/238/ 0 0/205/ 0 0/139/ 0 78/238/148 
120/255/ 0 120/255/ 0 120/255/ 0 120/255/ 0 120/255/ 0 146/171/148 
green greenl green2 green3 green4 SeaGreen2 



182 



LiquiFire User's Guide: Color Definitions 



84/255/159 46/139/87 46/139/87 46/139/87 67/205/128 60/179/113 
146/171/159 146/170/87 146/170/87 146/170/87 147/171/128 147/169/113 
SeaGreenl sea green SeaGreen SeaGreen4 SeaGreen3 medium sea green 



60/179/113 0/238/118 0/139/69 0/205/102 0/255/127 0/255/127 
147/169/113 150/255/118 150/255/69 150/255/102 150/255/127 150/255/127 
MediumSeaGrSpringGreen2 SpringGreen4 SpringGreen3 spring green SpringGreen 



• ' " 




• 









0/255/127 245/255/250 245/255/250 0/250/154 0/250/154 102/205/170 
150/255/127 150/10/250 150/10/250 157/255/154 157/255/154 160/128/170 
SpringGreenl mint cream MintCream medium sprinr^eiaimSpring©Bafeom aquamarine 



, mm 

102/205/170 102/205/170 127/255/212 127/255/212 118/238/198 69/139/116 

160/128/170 160/128/170 160/128/212 160/128/212 160/128/198 160/128/116 

^2^!^^^ an ^2i!^]lf^ ! 2? 3 aquamanne aquamarinel aquamanne2 aquamarine4 





64/224/208 32/178/170 32/178/170 72/209/204 72/209/204 131/139/139 
174/182/208 177/209/170 177/209/170 178/167/204 178/167/204 180/14/139 
turquoise light sea greenLightSeaGreerrnedtum turquditediumTurquaisere4 



193/205/205 
180/14/205 
azure3 



224/255/255 
180/31/255 
LightCyanl 



224/238/238 
180/15/238 
azure2 

Z 

209/238/238 
180/31/238 
LightCyan2 



240/255/255 240/255/255 224/255/255 224/255/255 
1 80/ 1 5/255 1 80/ 1 5/255 1 80/ 31 /255 1 80/ 31 /255 
azure azurel light cyan LightCyan 




; ::;::;S: : 5 ::, "\.:: : : 



180/205/205 122/139/139 175/238/238 175/238/238 
180/31/205 180/31/139 180/67/238 180/67/238 
LightCyan3 LightCyan4 pale turquoise PaleTurquotse 



102/139/139 187/255/255 150/205/205 174/238/238 47/79/79 47/79/79 
180/67/139 180/68/255 180/68/205 180/68/238 180/103/79 180/103/79 
Pale ■ : ..rquoiseffaleTurquoisePaleTurquoiseBaleTurquoiseSark slate grayDarkSlateGray 

47/79/79 47/79/79 141/238/238 151/255/255 721/205/205 82/139/139 
180/103/79 180/103/79 180/103/238 180/104/255 180/104/205 180/104/139 
dark slate greyDarkSlateGreyDarkSlateGrayl2arkSlateGrayQ>arkSlateGrayDarkSlateGray4 
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PHf I 1 | 


lllillli 


: / .:. 




0/139/139 


0/139/139 


0/139/139 


0/205/205 


0/238/238 


0/255/255 


180/255/139 


180/255/139 


180/255/139 


180/255/205 


180/255/238 


180/255/255 


cyan4 


dark cyan 


DarkCyan 


cyan3 


cyan2 


cyan 




iiiiiin siiiiiiiiii 

lllillli ' 


|| ffl 






0/255/255 


0/206/209 


0/206/209 


95/158/160 


95/158/160 


•0/134/139 


180/255/255 


181/255/209 


181/255/209 


182/103/160 


182/103/160 


182/255/139 



cyanl 



dark turquoise DarkTurquoisecadet blue 

lliilllllllll 



CadetBlue turquoise4 



0/229/238 
182/255/238 
turquoise2 

152/245/255 
186/103/255 
CadetBluel 



0/197/205 
182/255/206 
turquoise3 

176/224/230 
187/ 59/230 
powder blue 

' M >\$ 



0/245/255 
182/255/255 
turquoisel 



176/224/230 
187/ 59/230 
PowderBlue 



83/134/139 142/229/238 122/197/205 
185/102/139 186/102/238 186/103/205 
CadetBlue4 CadetBlue2 CadetBIue3 



104/131/139 173/216/230 173/216/230 
194/64/139 195/63/230 195/63/230 
LightBlue4 light blue LightBiue 



0/154/205 191/239/255 178/223/238 
195/255/205 195/64/255 195/64/238 
DeepSkyBlue2LightBlue1 LightBlue2 



0/191/255 0/191/255 0/191/255 
195/255/255 195/255/255 195/255/255 
deep sky blue DeepSkyBiue DeepSkyBluel 



0/104/139 0/178/238 154/192/205 135/206/235 135/206/235 141/182/205 
195/255/139 195/255/238 195/63/205 197/108/235 197/108/235 202/79/205 
DeepSkyBlue4DeepSkyBiue2LightBlue3 sky blue SkyBlue LightSkyBlue3 



?W?m&m ife^t*^ m m$mmms£t y $mmmm mssssm 

164/211/238 176/226/255 96/123/139 135/206/250 135/206/250 108/166/205 
202/79/238 202/79/255 202/78/139 203/117/250 203/117/250 204/120/205 
LightSkyBlue2LightSkyBlue1 LightSkyBlue4iight sky blue LightSkyBlue SkyBlue3 



135/206/255 126/192/238 74/112/139 927172/238 79/148/205 70/130/180 
205/120/255 205/120/238 205/119/139 207/156/238 207/156/205 207/155/180 
SkyBluel SkyBlue2 SkyBlue4 SteelBlue2 SteelBlue3 steel blue 



70/130/180 99/184/255 54/100/139 240/248/255 240/248/255 24/116/205 
207/155/180 207/156/255 208/155/139 208/15/255 208/15/255 210/225/205 
SteelBiue SteelBluel SteelBlue4 aliceblue AliceBlue DodgerBlue3 
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s^rit ^Bii ^M : X, 

mmkmmmmm wmSmMmm mmm^mmm 



30/144/255 30/144/255 30/144/255 28/134/238 16/78/139 112/128/144 
210/225/255 210/225/255 210/225/255 210/225/238 210/225/139 210/56/144 
dodger blue DodgerBlue DodgerBluel DodgerB!ue2 DodgerBlue4 slate gray 



112/128/144 112/128/144 112/128/144 119/136/153 119/136/153 119/136/153 
210/56/144 210/56/144 210/56/144 210/56/153 210/56/153 210/56/153 
SlateGray slate grey SlateGrey light slate grayLightSiateGra^ligrit slate grey 



119/136/153 159/182/205 198/226/255 185/211/238 108/123/139 110/123/139 



211/56/139 
SlateGray4 

* ■• 



213/53/139 
LightSteelBlue4 



210/56/153 210/57/205 211/57/255 211/56/238 

LightSlateGre>6lateGray3 SlateGray 1 SlateGray2 

B1 I 3/210/238 1 ( i 

213/53/205 214/53/238 214/52/222 214/52/222 214/53/255 219/147/237 
LightSteelBiueBightSteelBiueBght steel blue LightSteelBlueLightSteelBluedornf lower blue 

100/149/237 58/95/205 67/110/238 72/118/255 65/105/225 65/105/225 

219/147/237 225/182/205 225/183/238 225/183/255 225/181/225 225/181/225 

CornflowerBlu£loyalBlue3 RoyalBlue2 RoyafBiuel royal blue RoyalBlue 



1 IKiiB - m i mmmmm 

39/64/139 248/248/255 248/248/255 230/230/250 25/25/112 25/25/112 

225/1 83/1 39 240/ 7/255 240/ 7/255 240/ 20/250 240/1 98/1 1 2 240/1 98/1 1 2 

RoyalBlue4 ghost white GhostWhite lavender midnight blue MidnightBlue 















0/ 0/128 


0/ 0/128 


0/ 0/128 


0/ 0/139 


0/ 0/139 


0/ 0/139 


240/255/128 


240/255/128 


240/255/128 


240/255/139 


240/255/139 


240/255/139 


navy 


navy blue 


NavyBlue 


blue4 


dark blue 


DarkBlue 














0/ 0/205 


0/ 0/205 


0/ 0/205 


0/ 0/238 


0/ 0/255 


0/ 0/255 


240/255/205 


240/255/205 


240/255/205 


240/255/238 


240/255/255 


240/255/255 


medium blue 


MediumBlue 


blue3 


blue2 


blue 


bluel 




■11 








lllliil 

lllllil 



105/89/205 131/111/255 106/90/205 106/90/205 71/60/139 132/112/255 
248/144/205 248/144/255 248/143/205 248/143/205 248/144/139 248/143/255 
SlateBlue3 SlateBluel slate blue SlateBlue SlateBlue4 light slate blue 
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■ -j Hi ' - 1 1 

; wis. i Jii.arJH 

132/112/255 122/103/238 72/61/139 72/61/139 123/104/238 123/104/238 
248/143/255 248/144/238 248/143/139 248/143/139 249/143/238 249/143/238 
LightSlateBlueSlateBiue2 dark slate blueDarkSiateBlue medium slate ttteliumSIateBlue 



93/71/139 159/121/238 137/104/205 147/112/219 147/112/219 171/130/255 
259/124/139 259/125/238 260/125/205 260/124/219 260/124/219 260/125/255 
MediumPurpieWediumPurpleBlediumPurpieSiedium purpleMediumPurpleMediumPurplel 



155/48/255 138/43/226 138/43/226 145/44/238 125/38/205 85/26/139 
271/207/255 271/206/226 271/206/226 271/207/238 271/207/205 271/207/139 
purplel blue violet BlueViolet purple2 purple3 purple4 



160/32/240 104/34/139 178/58/238 191/62/255 153/50/204 153/50/204 
277/221/240 280/192/139 280/192/238 280/193/255 280/192/204 280/192/204 
purpie DarkOrchid4 DarkOrchid2 DarkOrchidl dark orchid DarkOrchid 





■8HNI 




























siillllillii 





154/50/205 
280/192/205 
DarkOrchid3 



148/ 0/211 
282/255/21 1 
dark violet 



148/ 0/211 

282/255/211 

DarkViolet 



1 80/ 82/205 209/ 95/238 224/1 02/255 
288/153/205 288/153/238 288/153/255 
MediumOrchidBlediumOrchidfilediumOrchidl 



122/55/139 186/85/211 186/85/211 139/123/139 

288/154/139 288/152/211 288/152/211 300/29/139 
MediumOrchidmedium orchicMediumOrchidthist!e4 

' ' 

238/210/238 255/225/255 139/102/139 255/187/255 

300/30/238 300/30/255 300/67/139 300/68/255 

thistles thistlel pium4 pluml 



216/191/216 
300/29/216 
thistle 



Mf'^M If 



205/150/205 
300/68/205 
plum3 



205/181/205 
300/29/205 
thistle3 



238/174/238 
300/68/238 
plum2 



221/160/221 
300/70/221 
plum 



238/ 0/238 

300/255/238 

magenta2 



238/130/238 139/ 0/139 139/ 0/139 139/ 0/139 205/ 0/205 
300/115/238 300/255/139 300/255/139 300/255/139 300/255/205 
violet magenta4 dark magenta DarkMagenta magenta3 



iiisisiBi mmm 

Im^SMmni WMmw+MMwB 

255/ 0/255 255/ 0/255 139/71/137 218/112/214 205/105/201 

300/255/255 300/255/255 302/124/137 302/123/214 302/124/201 

magenta magental orchid4 orchid orchid3 



186 



APPENDIX B 



HTTP Syntax Definition 



LiquiFire Syntax 



lfescoctet = "\" DIGIT DIGIT DIGIT 

lfunicode = "U" DIGIT DIGIT DIGIT DIGIT 

If escape = lfescoctet | lfunicode | escape 

If name = *( ALPHA | DIGIT ) 

Ifsafe = ALPHA | DIGIT | safe | lfescape 

1 freezes t = * ( If command } 

If command = If name ["=" lfargs ] 



If args 

Ifargkey 

If express ion 

lfargvalue 



= *( Ifargkey "[" lfargvalue 
= *( ALPHA | DIGIT ) 
= "<" *( If safe | " I " | | 
= lfsafe | lfexpression 



'J " 



Basic URI Syntax. 



For definitive information on URL syntax and semantics, see RFC 1738 and RFC 1808 



URI 




( absoluteURI | relativeURI ) [ "#" f 


absoluteURI 




scheme " : " 


* ( uchar | reserved ) 


relativeURI 




net_path | 


abs_path j rel_path 


net_path 




"//" netJLoc [ abs_path 3 


abs„path 




"/" rel_path 


reljpath 




[ path ] [ 


";" params ] [ »?» query ] 


path 




f segment * • 


( "/" segment ) 


f segment 




l*pchar 




segment 




*pchar 




params 




param * ( " ; 


" param ) 


param 




* ( pchar | 


V" ) 


scheme 




1*{ ALPHA [ 


DIGIT | " + " | " - " | " . " ) 


net_loc 




* { pchar | 


" ; " | " ? » ) 
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cjuery 




* ( uchar | 


reserved ) 


fragment 




* ( uchar | 


reserved ) 


pchar 


- 


uchar | " : 


" | "@" | " 


uchar 


- 


unreserved 


| escape 


unreserved 




ALPHA | DIGIT | safe 


escape 




"%" HEX HEX 


reserved 






i i ... 


extra 




» i " i n * it 


... | ,. r . 


safe 




» ^ .1 | .. _ .1 


._. | ... 


unsafe 




CTL j SP | 


< " > | » # » 


national 




"{" | "}" 


"I" | "\" 


lowalpha 




"a" . . "z" 




hi alpha 




"A" . , "Z" 




ALPHA 




lowalpha | 


hi alpha 


DIGIT 




"0" . . "9" 





;sbs 

ssfcss 
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appendix c Filter ControlValues 



Filter Type 


Level 


Sketch 


Degree of effect 


Emboss 


Degree of effect 


Denoise 


Degree of effect 


Implode 


Degree of effect 


Solarize 


Degree of effect 


Paint 


Size of brush 


Swirl 


Angle of swirling 


Shade 


Elevation of light 


Wave 


Amplitude 


Noise 




Despeckle 




Enhance 




Equalize 




Invert 




Normalize 




Spread 





Alpha 



Beta 



Angle of light 
Wavelength 
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r ;:: 



SI 

ii : 



hi s 
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appendix d Image Metadata Fields 



LiCJlliFire The following metadata fields are available for all images: 





LiquiFire Name 


Field Description 




colors 


Number of colors in the image 




colorspace 


Colorspace of the image; one of: RGB, Gray, Transparent, XYZ, 
YCbCr, YCQ YIQ, YPbPr, YUV, CMYK, sRGB 


'*! 


comment 


Textual comment for the image 




compress 


Compression type; one of: None, BZip, Fax, Group4, JPEG, 
LosslessJPEG, LZW, Runlength, Zip 




delay 


Inter-frame delay 




density 
depth 


pixel density 
bits per pkel 




dispose 


GIF disposal mode 




gamma 


Image gamma compensation value, if assigned 


:': a 


height 


Height of the image, in pixels 




interlace 


Image pixel organization; one of: Undefined, None, Line, Plane, 
Partition 




loop 


GIF/MNG looping repetitions 




matte 


True if the image contains an alpha channel 




monochrome 


True if the image is bi-level 




quality 


For compression technologies, indicates the quality' or 'lossiness' 
of the compression 




rendering_intent 


Color management profile rendering intent; one of: Saturation, 
Perceptual, Absolute, Relative 




subimage 


Number of frames in the image 




type 


Image data type; one on Bilevel, Grayscale, Palette, PaletteMatte, 
TrueColor, TrueColorMatte, ColorSeparation 
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LiquiFire Name Field Description 



units 



width 

x-resolution 
y-resolution 



Measurement units for density and resolution; one of: pixels/inch, 
pixels/mm 

Width of the image, in pixels 
Horizontal pixel density 
Horizontal pixel density 



192 



LiquiFire User's Guide: Image Metadata 



IPTC Metadata 



This standard, developed by a consortium of world-wide providers including Reu- 
ters and the Associated Press was designed to identify images, digital-audio, and dig- 
ital-video, as well as to identify the transport over which these media travel. Divided 
into two parts covering the transport and content, respectively, IPTC metadata has 
become the de-facto standard for image metadata due to the support of widely avail- 
able imaging packages such as Adobe™ PhotoShop™. 

LiquiFire supports and maintains any elements within Part 2 that are present in the 
original image. 



IPTC IPTC 

Name ID LiquiFire Name 



Field Description 



action 
advised 



2:42 actionadvised 
by-line 2:80 byline 

by-line title 2:85 bylinetitle 



caption/ 
abstract 

category 

city 

contact 



2:120 caption 

2:15 category 

2:90 city 

2:118 contact 



content 2:26 contentlocationcode 

location code 



content 
location 
name 



2:27 contentlocationname 



copyright 2:116 copyright 
notice 

country/ 2:100 primarylocationcode 

primary 

location code 

country/ 2:101 primarylocationname 

primary 

location 

name 



Action code, defined by image provider 

2 digits 

Photographer's Name 
32 characters 

Photographer's title. For example, House 
photographer or correspondent etc 
32 characters 

Full text of caption 
2000 characters 

The subject of the image 

3 letter code 

City of image origin 
32 characters 

Contact for further image information 
128 characters 

Country in which the captured event took 
place 

3 letter code 

Country in which the captured evenr took 
place; full name 
64 characters 

The image provider's copyright notice 
128 characters 

Country in which the image was captured 
3 letter code 



Country in which the image was captured; 
full name 
64 characters 
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IPTC 1PTC 

Name ID LiquiFire Name 



Field Description 



o 



credit 



2:110 credit 



date created 2:55 datecreated 

digital 2:62 digitalcreationdate 
creation date 

digital 2:63 digitalcreationtime 
creation time 

edit status 2:07 editstatus 



editorial 
update 

expiration 
date 

expiration 
time 

fixture 
identifier 

headline 



2:08 editorialupdate 

2:37 expirationdate 

2:38 expiration time 

2:22 fixtureidentifier 

2:105 headline 



image 
orientation 



2:131 imageorientation 

image type 2:130 imagetype 

object cycle 2:75 objectcycle 

object name 2:05 objectname 



original 

transmission 

reference 



2:103 original transmissionrefe 
rence 



originating 2:65 originatingprogram 
program 



Identity of the provider. Possibly an 
organization representing the capturer 
32 characters 

Date of event 

(not necessarily digitization time) 
Date digital conversion took place 

Time digital conversion took place 

Status of the object data 
64 characters 

Indicates edits made to other fields 
fieldID 

The latest valid date at which this image 
may be used 

The latest valid time at which this image 
may be used 



Synopsis of the subject matter 
256 characters 

Portrait: P, Landscape: L, Square: S 
Single character code 

Code representing image data 
composition 

For images with cyclic use, indicates 
Morning, Evening, or Both 
1 character 

Image title 
64 characters 

Provider's code indicating image 
transmission origin 
32 characters 

Name of digitization program 
64 characters 



program 
version 



2:70 



programversion 



Version of digitization program 
10 characters 
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IPTC 


IPTC 






Name 


ID 


LiquiFire Name 


Field Description 


province/ 


2:95 


province 


Province or State of image origin 


state 








reference date 


2:47 




Provider origin date 


reference 


2:50 


reterencenumber 


Provider origin numeric code 


number 






8 characters 


reference 


2:45 


r 

reterenceservice 


Provider origin service name 


service 






10 characters 


release date 


2:30 


releasedate 


Earliest permissible image utilization date 


release time 


2:35 


releasetime 


Earliest permissible image utilization time 


source 


2:115 


source 


Original image owner or creator 
32 characters 


special 


2:40 


specialinstructions 


Special handling instructions 


instructions 






255 characters 


sub-location 


2:92 


sublocation 


Identification of sub-location 
32 characters 


subject 


2:12 


subjectreference 


Colon ( : ) separated list of Subject 


reference 






Reference Number, Subject Name, 
Subject Matter, Subject Detail Name 
236 characters 


time created 


2:60 


timecreated 


Time of event 

(not necessarily digitization time) 


urgency 


2:10 


urgency 


Urgency, from 1 (most) through 8 (least) 
1 digit 


writer/editor 


2:122 


writereditor 


Name of metadata author 



32 characters 
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EXIF Metadata 



Exif data is captured from images originating in any of the following formats: BMP, 
GIF, JPEG (jFIF/eXIF), PNG, SVG, XBM, XPM. 



LiquiFire Name Field Description 



FNumber 

BitsPerSample 

CompressedBitsPerPixel 

ExposureTime 
FocalLength 
SubjectDistance 
YCbCrSubSampling 

XResolution 

YResolution 

WhitePoint 

PrimaryChromaticities 

YCbCrCoefEcients 

ReferenceBlackWhke 

GPSLatitude 

GPSLongitude 

GPSAltitude 

GPSTimeStamp 

GPSDOP 

GPSSpeed 

GPSTrack 

GPSImgDirection 

GPSDestLatitude 

GPSDestLongitude 

GPSDestBearing 

GPSDestDistance 

MakerNote 



Recriprocal of the aperature of the lens at time of capture 
Number of bits per pixel sample 

Compression model used for the image, expressed in bite per pixel 
sample 

Time at which the image was captured 

Focal length of the lens, in millimeters, at time of capture 

Fistance, in meters, to the subject 

Sampling ratio of chrominance components in relation to the 
luminance component. 

Horizontal image pixel density 

Vertical image pixel density 

Chromaticity of the white point of the image 

Chromaticity of the three primary colors of the image. 

The matrix coefficients for transformation from RGB to YCbCr 
image data 

Reference black point and white point values 
Latitude, in degrees, minutes, seconds, N/S 
Longitude, in degrees, minutes, seconds, E/W 
Altitude, in meters 
Time of data acquisition 
GPS Degree Of Precision 

GPS receiver speed of movement, in kilometers/hour (K), miles 
per hour (M), or Knots (N) 

GPS receiver direction of movement, in degrees 

Direction in which the image was captured, in degrees 

Latitude, in degrees, minutes, seconds, N/S, of the destination 

Longitude, in degrees, minutes, seconds, E/W, of the destination 

Bearing to destination point, in degrees 

Distance to destination point, in degrees 

Manufacturer device identification information 
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INDEX 



Symbols 

. (dot) 13 

_ (current image) 2 
A 

accounts 26 

actionadvised 193 

activity 40 

addalpha 151 

addframe 81 

addprofile 10,83 

alpha channel 70,99 

alphafill 84 

annotate 9, 10, 85 

argument 4 

art 10,83 

aspect-ratio 65 

asset 7 
cache 7, 19 
cache expiry 32 
cache flushing 52 
cache validation 32,51 
resident 7, 10, 45, 46 
source 7 

attribute 70, 88 

auth 18, 161 

authorized hosts 31 

B 

banner 69 

batch processing 19 

bevel 89 

bitspersample 196 
blank 8, 73 
blur 91 
border 93 
brightness 95 
bullet 152 



byline 193 
bylinetitle 193 

C 

cache 19, 45 
calculations 65 
caption 193 
category 193 
chain 10 

chain representation 4 
chainboard 55 
cipher 18,58, 161 
city 193 

cluster 10,22,35,45,48 
member management 25 
synchronization 10, 45, 48 

CMYK 12 

color 173 

color management 1,83 
color profiles 10 
colorize 96 
colors 191 
colorspace 191 
command 6 
comment 191 
composite 7,70,98 
compress 191 

compressedbitsperpixel 196 
conditional execution 12 
configuration 21,25 

administration users 26 

autostart 29 

cache expire 32 

cache memory 32 

cache size 32 

cache subsystem 32 

cache synchronize 32 

database host 33 
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domain 28 
e-mail 29 
FQDN 29 
hostname 28 
IP address 28 
license key upload 37 
liquifire cache 32 
liquifire client access 31 
liquifire cluster 30 
liquifire database 33 
liquifire host 28 
luster 28 
mailhost 29 
network 28 
port 28 

remote access cluster 35 

remote access FTP 34 

restart 38 

security 28 

security type 29 

server control 38 

server name 28 

URI 29 
configure 24 
contact 193 

contentlocationcode 193 
contentlocationname 193 
contrast 105 
copyright 193 
countdown 15, 162 
credit 194 
crop 106 
current image 2 

D 

database 15 
date 11 

datecreated 194 
decisions 11 
delay 191 
delete 47 
denoise 115 
density 191 
depth 191 
despeckle 115 
digitalcreationdate 194 
digitalcreationtime 194 
direct commands 3 
disk space 41 
dispose 191 
double 108 
draw 109 
dump 160 



E 

edit 47 

editorialupdate 194 
editstatus 194 
emboss 115 

Encapsulated PostScript 1 
encoding 11 
enhance 115 
EPS 1,67 
equalize 115 
escape 173 
esoteric metadata 13 
examples 61 
expirationdate 194 
expirationtime 194 
exposuretime 196 
expressions 11 
extensible 15 

F 

Facsimile 63 
file 7, 45 
fill 114 
filter 115,189 
fixtureidentifier 194 
flipx 117 
flipy 118 
fnumber 196 
focallength 196 
folder 46 
font map 57 
fontmetrics 15, 164 
fonts 10 

format conversion 62 
formats 
BMP 63 

Encapsulated PostScript 1 
EPS 1,67 

Exchangeable Image File 13 
EXIF 13 
g3fax 63 
GIF 67 

Graphics Interchange Format 67 
Group 3 Facsimile 63 
PDF 63 

Portable Document Format 63 
Scalable Vector Graphics 1 
SVG 1,67 

Tagged Image File Format 63 

TIFF 63 
frame 119 
ftp 7 

function 9 
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G 

g3fax 63 
gamma 122, 191 
gaussian blur 123 
gblur 123 
glyphs 57 
GPS 196 
grid 120 

H 

half 125 
hash 18, 161 
headline 194 
height 191 
hexadecimal 173 
host 

authorization 31 
host authorization 17,31 
http 7 
hue 126 

I 

ICC profile 83, 131 
icon 64 
if 12 
if-then 11 

image chain 3, 10, 15, 54 

cipher 58 

representation 4 

validation 55 
image creation 8 
image pool 2 
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